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This document provides reference data for the experienced programmer who is familiar with the B 6700/° - 
B 7700 Network Definition Language (NDL) and the B 6700/B 7700 Data Communications et : 


This reference manual i is divided into the following six chapters and five appendixes. 


. 


Chapter I, INTRODUCTION, describes where the NDL Mariual fits into the existing Data. | 
Communications System documentation, and defines the scope of NDL. | 


Chapter 2, NDL SYNTAX CONVENTIONS, explains t the syntactical notation used in defining the : 
Network Definition Language. 


Chapter 3, LANGUAGE COMPONENTS, describes the elements that form the most pa miye 
structures of the language. 


Chapter 4, SOURCE PROGRAM STRUCTURE, describes the basies structure of an NDL program. 


Chapter 5, DEFINITIONS, describes the various definitions. that make up an NDL program. 


Chapter 6, VARIABLES, describes the program variables available to the NDL Programmer. 
Appendix A, RESERVED WORDS, is a list of “words” that have been set aside for gd 


purposes within the Network Definition Language. 


Appendix B, TRANSMISSION CODES, provides aisha data transmission ‘code ‘abies 


Appendix C, SOURCE INPUT FORMAT AND CODING FORM, describes the input format and — 


coding form to be used by the programmer. 


Appendix D, COMPILE-TIME OPT IONS, Geccites the compiler options available to the user. 


Appendix E, COMPILER SOURCE AND OBJECT FILES, describes how compiler communication 
is handled through various input and output files. 


The information in the following documents pertains to and supplements the material sreeica in this 
‘reference manual: 


Title eo oo Form No, 


-B 6700/8 7700 Data Communications Functional Description e ar ee 5000060 | 
- B 6700/B 7700 DCALGOL Reference Manual Ry 5000052 


_B 6700 but output Subsystem Information Manual >= a ee. 000185 
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_cally, logically, and functionally. Physical components of a data com 


1, INTRODUCTION _ 


GENERAL | 


This document is one of several documents concerning the B 6700/B 7700 Data Communications System. ~ 
The hierarchy of these documents is illustrated in figure 1-1. Note that information contained in the 
B 6700/B 7700 Data Communications Functional Description, form no. 5000060, and B 6700 Input/ | 


Output Subsystem Information Manual, form no. 50 } 


0185, is prerequisite to this document. _ 


- SCOPE OF NDL 


The Network Definition Language (NDL) source program describes a data communications network physi- 
ware specifications and capabilities of the various elements which comprise the network. The logical charac- 
teristics of a network are the associations among the various components of a data communications subsystem — 
(user programs, Message. Control Systems, etc.), application-oriented chara teristics (page size and width, ~~ 
special-purpose characters, etc.), and the symbolic names tsed to reference ‘physical elements within the - 
network, Figure 1-2 illustrates the physical and logical characteristics in their relation to the network ele- - 
ments, Figure 1-3 illustrates the sphere of influence of a NDL source program\on. the logical and physical — 
components of a Data Communications System. The area enclosed by the broken line is the “global sphere 


of influence.” The shaded area indicates the “local sphere of influence.” The akrows indicate the flow of 


information. . . a Ce oo a 


NDL also specifies the functional behavior of the network or the way in which eack data communications — 


line is to be controlled. These specifications consist of individual routines, allowing\the NDL programmer to ~ 


implement the protocol required to meet the physical characteristics arid application: of the types of term- 


inals that have been defined. The routines are compiled into a set of instructions whi 
tions Processor (DCP) executes to perform the functions described by the NDL program. 


th the Data Communica- 


The NDL source program is transformed into two files containing the information sea to operate the | 


defined network: a | 


a. The Network Information File (NIF), containing the logical and physical specifications of the network. 


b. The DCP Code File (DCPCODE), containing the Data Communication Processor (DCP) hardware 
instructions for operating the network. a ae ee es en ee 


USE OF NDL 


Once the data communications hardware has been installed ona B 6700/B 7700 system, several software 


_ Systems are required to generate and operate the data communications network. These packages, illustrated © 


in figure 1-3, consist of one or more Message Control Systems (MCS), the Data Comm Controller (DCC), and 
the NDL compiler. The purpose, function, and use of each. of these software items are described in the follow- 


munications network include the hard- 
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Physical location (address) 
Transmission speed | 
Type of line and connection — 


Station line assignments 
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| Continuous VS. controlled carrier. _ 


PL symbolic name 
STATIONS ee Terminal characteristics . - | Logical attributes : | 
| ~ . 27 a 1 - Associated Message Control System. 


Transmission code, speed and nee | . Transmission cimbers 
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_ Figure 1-2. Network Characteristics 
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Message Control System (MCS) 


An MCS is a special purpose DCALGOL program which may be a Burroughs-supplied MCS (SYSTEM/CANDE, | 
SYSTEM/RJE, or SYSTEM/DIAGNOSTICMCS), or a user-written program. The primary function of an | 
MCS is, as its name implies, to control the flow of data communications messages between the terminal and 
the main system. Information from the DCP, such as terminal input and status information, is forwarded to 
the MCS via the DCC. Messages from the MCS to the DCP, such as terminal output or network changes, are 
performed by the MCS invoking an intrinsic function called DCWRITE. This intrinsic, as well as the format 
of all MCS and DCP messages, is described in the B 6700/B 7700 DCALGOL Reference Manual, form no. 
5000052. Each station ee is defined by the NDL source progam must have one, and Bnly one, control- 
ling MCS. | 


Data Comm Controller (DCC) 


The DCC is the basic interface between the DCP and the main system. It exists as a subset of the basic 
B 6700/B 7700 Master Control Program (MCP) and operates as an independent task or stack, one such task - 
for each active DCP. 


Before a defined data communications network may be utilized, the DCPs which comprise the network must 
be initialized. As each DCP is initialized, the portion of the NDL- defined network which utilizes that DCP 
becomes active. 


Once initialized, each DCC stack transfers messages between the associated DCP and the proper MCS. 
NDL Compiler 


Whereas the DCC and an MCS are geared to operate a alge communications network, the NDL compiler 
is used to generate the tables and DCP code which, to a large extent, control the way in which the network 
functions. 


The NDL source program, then, must supply the NDL compiler with information which will allow the com- 
piler to produce the proper NIF and DCPCODE files to operate all of the Data Comm Processors and their 
sub-components within the network. (In figure 1-3, the shaded areas indicate the areas of the data communi- 
cations subsystem which are influenced by the NDL source program.) Although an NDL program may con- 
tain up to 11 discrete sections, it functionally consists of two meMepengent pieces of information: the 
network description and the DCP programs. 


NETWORK DESCRIPTION 


The NDL programmer uses various sections of the NDL source program to describe the logical and physical 
characteristics of the network. The information supplied in those sections is used, in: part, to SRD the DCC 
with the proper tables and DCP code that are used to operate the network. 


The NDL compiler performs consistency checks across the various definitions to ensure that the defined 
network is logically structured. For example, a line must not be associated with a particular modem if the 
defined speed range and transmission type of the modem do not permit a proper interface to the line. Simil- 
arly, a terminal defined to operate in-an asynchronous mode must not be associated with a line which uses a | 
synchronous adapter. 


All of the information supplied by the NDL definitions is fe andes within the NIF file. This enables an MCS 


Or user program to gain access to many of the logical characteristics of the network, as well as permitting 
dynamic reconfiguration of the network Py an Eee -_ | | 
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These definitions are also used to modify or include special areas of DCP code which are network dependent. 
For example, the DCP code for transmitting or receiving characters on a synchronous line is differe:t from 
such code for transmitting or receiving on an asynchronous line. In addition, if any dial-out type lines are 
detined within the network, extra code must be generated for performing dial-out functions. Thus, the NDL> 
compiler “tailors”’ the resultant DCPCODE file to fit all the requirements of the defined network. 


DCP PROGRAMS 


Once a data communications network is logically and physically defined, the functional operation of each 
line and station within the network must be described. These descriptions, called CONTROL definitions 

and REQUEST definitions, are individual programs which are executed by the DCP when required to perform 
the necessary line discipline. Each line must have one associated CONTROL definition, and each terminal 
may have one or more associated REQUEST definitions. 


The CONTROL and REQUEST definitions consist of NDL statements which the compiler transforms into 

the DCP instructions to be executed when performing a particular network function. A RECEIVE REQUEST 
definition .is invoked when input from a terminal is to be processed, and a TRANSMIT REQUEST definition 
is executed when output to u terminal has been requested by an MCS or user program. The line CONTROL 
definition is utilized to determine when and for which of the stations on the line a REQUEST definition i is 
to be executed. 


Since an NDL source program must handle many lines, the DCP must share its processing capabilities among 
the lines it services. Due to the fact that the data communications subsystem operates in a real-time environ- 


ment, few network functions, if any, require the dedicated use of the DCP for an extended length of time. | \w// 
A RECEIVE REQUEST, for example, usually spends most of the time waiting fora character to be sent from = er 


a terminal. Likewise, a TRANSMIT REQUEST can only operate as fast as the line spced permits. Thus, while 
a REQUEST definition is waiting for an external event, or interrupt, from a line, the DCP is free to continue 
execution of a REQUEST or CONTROL definition for another line. 


The siigeation of the DCP for the servicing of its many lines is one of the duties of the basic DCP operating 
system and the CONTROL definitions. Figure 1-4 illustrates the means by which the control of the DCP 
is transferred between the operating system and the CONTROL and REQUEST definitions. 


Line Control 


Each CONTROL definition, or “‘Line Control Procedure,’’ must perform two functions. First, it must select 
which station on the line is to receive attention next, and second, it must decide what particular function is 
to be performed for that station. If the function to be performed | is an output request, control is transferred 
to the TRANSMIT REQUEST for the station. If the function is an input operation, the station’s RECEIVE. 
REQUEST is executed. Network functions which do not involve the reception or transmission of messages, 
such as status or network changes, are performed by penne a common subprogram, or macro, within the 
DCP operating system itself. 


Request Definitions | 


For each type of fecmitril which is capable of output, a TRANSMIT REQUEST must be named within he 
terminal definition. Likewise, if a terminal has input capabilities, a RECEIVE REQUEST must be supplied 
and named. Typically, many stations may share the same REQUEST definitions, just as many lines may _ o~ 
utilize the same CONTROL definition. In some cases, more than one set of ne definitions may be \ cage 

desired, and defined, for a station. | o 


DCP 
Operating 
System 


| ine | Initiate Request ~ | Terminal 


‘DCP Initialization | | ~ : ‘ 2 
~| . Control | Terminate Request | Request a 
Procedure oc ae | Routine : 


DCP 


Common [| | | | a 


Macros 


Figure 1-4, Transfer of Control Within the DCP 


The functions of a REQUEST definition may be as simple or as complex as the application of the station © 
dictates. One of the basic design goals of the DCP is to free the main system from the burden of performing _ 
basic terminal receptions and transmissions. However, by the proper application and coding of the CONTROL 
and REQUEST statements in NDL, a significant amount of intelligent message processing may be performed — 
by the DCP, thereby allowing more of the main system’s resources to be free to perform other work. 


The NDL programmer must a in mind, however. that the DCP runs at a finite rate, and that it is 
operating in real-time. Thus, if too much time is spent processing a message, other lines may fail to be 
serviced quickly enough to avoid transmission errors. Several NDL statements are provided to “break up” 
long strings of NDL code to ensure that the DCP may properly service all of its lines. 


When a REQUEST definition has terminated the processing of an input or output function, it usually branches 
back to the beginning of the CONTROL definition. The CONTROL definition then selects the next station — 
to be serviced and the process continues. 


Thus, the functioning DCP can be visualized as a small multiprogramming system, where each line has its own 
program and operating environment and runs asynchronously and independently of the other lines. The 
CONTROL definition and its associated REQUEST definitions form the “main program for. each line, and 
the common DCP macros are “‘sub-programs.” 


DCP INTERACTION WITH THE MAIN SYSTEM 


Although the DCP is a self-contained and asynchronous device with respect to the main system, it is not an — 
autonomous unit, and requires the active participation of the main system and its resources to properly func- 
tion. In particular, main memory storage space is required to contain tables and messages. In addition, the 
DCP requires the allocation of a pool of message areas in main memory for the gathering of input from term- 
inals and reporting of error conditions. | 


DCP Tables 


The NDL compiler constructs a series of tables which reflect the physical and logical characteristics of the 
network as defined by the NDL source program. The DCP uses these tables for the storage of status informa- 
tion, and for. determining what types of functions are - to be performed for each of the many different lines: 
and stations which the DCP controls. , 


The compiler places a disk image of hese tables within the DCPCODE file along with the DCP mers itself, 
When the DCP is initialized, the tables are loaded into main memory by the DCC, which also provides the 
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DCP with a reference to the tables. If several DCPs exist which share hardware-cxchanged adapter clusters, — 
two DCPs may utilize the same set of tables if the network description indicates this mode of operation. In 
the case where a DCP is not “‘exchanged”’ in this manner, cach DCP uses its own unique set of tables. 


Each set of tables can be divided into two sets of information. Each line has a table, and each station has a 
table. The DCP uses a “‘line descriptor” to reference each line table. The descriptors for all lines controlled 
by the DCP are stored within a vector, which is then indexed by the physical line adapter address. Each line 
descriptor contains information concerning the status of the line (not ready, connected, busy, etc.), physical 
characteristics of the line (dial-out, switched, etc.), logical characteristics (automatic answer, etc. ), and a | | 
reference tc the CONTROL definition which is used for the line. In addition, the line-descriptor contains 

the memory address of the-actual line table. | 


Each line table contains additional information describing the logical and physical characteristics a the. line. 
Much of the information in the line table can be referenced and/or modified directly by the NDL CONTROL 
and REQUEST definitions. Other information i is reserved for use by the DCP operating system. 


Immediately following the line information in the line table is a vector of station descriptors, one such 
descriptor for each station which can exist on the line. Similiar to the line descriptor, each station descriptor 
addresses a table of information for a particular station. The DCP references the proper station tabie by _ 
indexing into the line table by the proper relative station address, or “station index,” and using the addressed 
station descriptor to reference the proper station table. When a line CONTROL Procedure ‘ ‘selects” a station 
for the purposes of initiating a REQUEST definition, it-is actually selecting the proper station table for use. _ 
Just as the line table contains a reference to the proper CONTROL definition to execute, the station table = = 
contains references to the appropriate TRANSMIT and RECEIVE REQUEST definitions. Itshouldnowbe 
apparent that each station assigned to a particular line must utilize the same Line Control Procedure, since 

the stations on the line all share a common line descriptor and line table. However, each station may have a 
different set of REQUEST definitions, since these routines are station oriented. 


Although each station table is of a fixed size, the line tables will vary in size. directly seopeHtionil to the 

number of stations which can potentially exist on the line. The NDL source program specifically defines 

the maximum number of stations for each line, as well as which stations are assigned to what line. Not all 
station descriptors may be utilized for a given line, i.e., the number of real stations on a line at any given 
moment may be less than the true capacity of the line. A line may be declared with such “holes” when the — 
NDL program is compiled, or a line may be reconfigured into such a state by an MCS. In some cases, a line 

may exist with no stations at all. At no time, however, may more stations be assigned to a line than the max-__ 
imum number defined by the NDL program. Thus, it is the requirement of the DCP operating system and/or 
the CONTROL definitions to ensure that a selected station actually exists, or is valid, as defined sh the cur- 
rent state of the network. | | 


Just as a line may have no valid stations, it is possible and often desirable to define ‘“‘spare”’ stations which 
have no line assignment. . Such stations cannot be referenced or utilized by the DCP until they are logically - 
assigned to a line by a reconfiguration request. Again, any such reconfiguration request will be disallowed _ 
by the DCC if the characteristics of the station conflict with those of the line to which it is being assigned, 

or with the stations which already exist on that line. Also, since the size of the line table cannot be altered, 
there must exist a ‘‘hole” or unused position on the line for ine station. 


Alternatively, an existing station may be subtracted from a line, thereby leaving a “hole,” and either left | 
in limbo with no line assignment, or moved to fill an existing “hole” on another line. Thus, stations which 
have special characteristics for a particular application may be logically moved about within the network 
while the data communications system is operating and without the further use of the NDL compiler. | 


DCP MESSAGE MAINTENANCE 


With one exception, all functions Be ie by the DCP are the direct result of a DCP request message being 
sent to the DCP, usually by an MCS. In the case of terminal output, for example, a “write request” is sent 


to the DCP, which then invokes the action described within the request message itself by means of the. appro-_ E - | 


priate station’s TRANSMIT REQUEST definition. If spontaneous input from a terminal is to be received, 


there is normally no MCS request message associated with the input operation. When a station operatesin __ 


this mode, the terminal is described as being ‘‘enabled for input,” or simply, neice i 


The process of gathering “enabled input messages,” i.e. , spontaneous input messages, ‘is controlled by ne : 
CONTROL definition, and, of course, by the RECEIVE REQUEST defined for the terminal. . In addition, 


the ‘‘enabled”’ state of a station is initially defined for each station, and may be ayriamnically changed by the: | 
controlling MCS. 


When a station is enabled, and the RECEIVE REQUEST is invoked, the DCP must then seyenee message _ 
area in main memory in which to store the received message text. Such an area, which is called an ‘“‘enable 
input space,”’ is obtained by a DCP macro called GETSPACE. Since the DCP cannot directly participate in 
the main system memory management functions, a pool of such “enable input” spaces is maintained by the 
DCC. This pool of messages, sometimes refcrred to as the “available space pool, ” consists of a set of queues, 
each of which contains a linked list of available message arcas of the same size. The NDL compiler computes 


the size of the enable input space required for each terminai based on the defined WIDTH, MAXINPUT, and | 1 
BUFFERSIZE statements within the terminal definition. All terminals of a given size are assigned the use of _ 


the same queue. In order to reduce the number of different queues required, ne NDL compiler rounds.each | 
terminal's input size up to a multiple of 16 words. | 


The available space areas are used for several purposes other fhan terminal snabied: input. E rror messages 
from the DCP and ‘‘switched line status” result messages are also spontaneous in nature and require an enable 
input space. In addition, it is possible for an NDL Request definition to invoke the GETSPACE macro and 
simply store the contents of variables in the obtained message space in order to. communicate with the con- 
trolling MCS. . | 


When the DCP une macro is invoked, an area which is greater than or equal to the eee ee message 
size is delinked from a message queue and assigned to the station. If no suitably sized.areas exist within the 
space pool, a “no cane condition results, and the RECEIVE REQUEST must abort reception of input. 


The number of messages assigned to each queue iS imiially defined by the NDL eonisiler: By default, two 7 


areas are assigned to each size queue, although the NDL program may specity an peerare allotment ona. 
terminal by terminal basis. | | | : 


The DCC has the responsibility of maintaining the available space. pool so that GETSPACE : may always ob- 
tain a message area. As each available space area is returned to the DCC by the DCP in the normal course of 
completing an input operation, the queue from which the area was obtained is restored so that it contains 

the same number of areas as defined by the NDL compiler. Circumstances may arise, however, where all of 
the areas within a queue have been exhausted, but none of the areas has yet been returned to the DCC so that 
the queue can be replenished. In such an event, the DCP sets a global “‘space alarm” flag which is sensed by 
the DCC and causes it to immediately examine and replenish all of the available space queues. In addition, 
the DCC will then increase the target number of messages in each totally depleted queue, in order to reduce 
the possibility of future space alarms. During extended periods of DCP inactivity, the DCC will attempt to | 
reduce the number of messages in each queue down toward the originally defined target value. — 
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The DCC attempts to maintain the available space pool within the constraints specified by the NDL compiler. 
However, some networks may require more than the default number of message areas for some terminals a 
if too many “no space” conditions occur. In such an event, the NDL program should specify a larger number | 
of message areas for the affected terminals. Since the behavior of a network is difficult to predict under all 
circumstances, the NDL programmer will have to directly observe the effects of different message space spec- 
ifications, and adjust the specifications so that the network operates efficiently without requiring excessive 
memory resources. | | | . a 


1—10 


NDL Syntax Conventions 
SYN7?,.s CONVENTIONS 


2. NDL SYNTAX CONVENTIONS 


SYNTAX CONVENTIONS 


The syntax diagram is the method used to depict the Network Definition Language syntax. ._ This method 
affords a very concise and lucid exposition of syntax, including defaults, alternatives, and iterations; it is 
rigorous without being cumbersome. There are few formal rules to remember: the basic rule is that any 
path traced along the forward directions of the arrows produces a syntacheally valid. command. The 
following examples illustrate the euane: 


brow THE as on nT DOWN 
YOUR GENTLY a 


;> STREAM. _ 


Valid constructs from this syntax diagram include: 


Racy ROW THE BOAT DOWN-STREAM. .___ 
: | ROW, ROW, ROW YOUR BOAT GENTLY DOWN THE STREAM. 
ROW, ROW, ROW, ROW THE BOAT DOWN THE OLD STREAM. 
ROW YOUR BOAT DOWN THE OLD, MILL STREAM. _ 
ROW THE BOAT DOWN THE OLD, MILL STREAM. 


The following convention is used to control iterations of options or constructs: 


ACROSS THE MISSOURI | 


The “bridge” over the “2” can be crossed a maximum of two times, soa maximum i two commas (and 
three adjectives) can appear. Valid productions include: | 


ACROSS THE BIG MISSOURI — 
ACROSS THE BIG, WIDE MISSOURI. a 
ACROSS THE BIG, WIDE, MUDDY MISSOURI 


From the above example, it should be noted that the number of iterations is controlled by the ‘“‘number”’ 
in the feed-back loop. When the “number’”’ is not shown, there is no limit to the iterations. For example, — 


NDL Syntax Conventions 
SYNTAX CONVENTIONS 


Continued 


ACROSS THE . MISSOURI 


would include the following valid combinations: 


ACROSS THE BIG BIG WIDE WIDEMISSOURI 
ACROSS THE BIG MISSOURI __ | 
ACROSS THE MUDDY MUDDY MUDDY MUDDY MISSOURI 


If a comma were included in the above example, valid combinations would be as follows: © 


ACROSS THE BIG, BIG, MUDDY MISSOURI _ 
ACROSS THE BIG, WIDE, WIDE, MUDDY MISSOURI | 


Key Words 


Boldface symbols and uppercase letters in syntax diagrams indicate symbols and words which appear | 
literally in the instruction. ; ee 


Syntactic Variables 


In the syntax diagrams, left and right broken brackets (¢ )) are used to contain syntactic variables that 
represent information to be supplied by the programmer. A particular variable may representa single 
character, a simple construct (such as an integer or text string), or a relatively complicated construct. 


The following is an example of a syntactic variable that appears in a syntax diagram. 
DEFAULT ——-—_—- = ——__—__> ( default line identi fier) 7 


Braces ({ t) are used to enclose syntactic variable expressions defined by the meaning of the English — 


language expression contained within the braces. For example, the following syntactic variable expression 
ADAPTER————_-- = —____—+ | ‘ integer) value of 1 thru 8 pa ; 


would include the following valid constructs: : 


ADAPTER = 1. 
ADAPTER = 6. 
ADAPTER = 8. 


Construct Terminator 


Most constructs in the Network Definition Language must be terminated by a period (.). This is illustrated 
in the syntax diagrams as follows: | | | 


The period is part of the syntax and must appear following the construct. 
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. NDL Syntax Conventions | 
SYNTAX CONVENTIONS - 
Contiired | | 


Some constructs, howeve 
illustrated as follows: 


r, do not require a terminator, and can be followed by another construct. Thisis 


The vertical bar ( | ) is hot part of the syntax, but merely indicates the termination of the construct. 
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a. 
3. LANGUAGE COMPONENTS | 
LANGUAGE COMPONENTS 
Syntax | 
, > (bit number) - 
> (bit variable) 
- <byte variable - 
p- (character ) 
— (identifier) - 
= Cinteger) 
(label) 
-s- (NDL program unit)— 
> (remark) 
- = (reserved word) — 
. —e (space) 
= > (string) 
3 (system identifier) - 
(tally number) - 
(time) : 
(toggle number’ 
Examples 
A 
450 
6110 
IF 
““B6700” 
SYSTEM/CAN DE 
30 MILLI 
Semantics | | - | | 
(bit variable)s, (bit number)s, and (byte variable) s are all described in chapter, 6. 
A complete list of the (reserved word)s i iS contained i in appendix. A. 
(NDL program unit) is described in chapter 4. : oo 
a All other (language component)s ' are described in this chapter. 


Language Components 
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CHARACTER > 


Syntax 


. (digit) — 
(hexadecimal character) 
(letter) 


(single character) 


Examples 
oO; 

9. 

A 
al’ fd 
Semantics 


In all instances, a (character). is an entity whose exact form depends on the context of its usage. The - 
normal inference is that of an 8-bit EBCDIC character. oe : . 


(letter) s and @igit)s are usually used to create (identifier) s and string) S. 


Wherever (single character) occurs in the NDL syntax, an &-bit character is needed. It is unique in that it 
may be formed using two ¢ hexadecimal characters. , rr oe 


Language Components ee 
CHARACTER | 
(ee git) | 


DIGIT 
Syntax | 
jone of the EBCDIC characters, O through 9, inclusive} 


Examples 


0 
5 
9 


_ Semantics 


Whenever the item of (digit) appears in the NDL syntax, one of the 10. numeric EBCDIC characters from: 
O through 9 is eequired: | | | 


Language Components 
CHARACTER | 
‘hexadecimal character) 


HEXADECIMAL CHARACTER 
- Syntax ? a 
(digit) 
> E 
Examples 
a 
5 
9 
A. 
C 
F 
Semantics 


hexadecimal character) s are defined as consisting of the characters in the decimal digit set plus the char- 


acters A, B,C, D, E, F. ( hexadecimal character) s are generally used to define program values in terms of 
the hexadecimal (radix 16) number system, where A is equivalent to 10 in the decimal system, B is equival- 
ent to 1] in the decimal system, etc. _ | | a - 4 


Language Components ae 
‘CHARACTER ~ 
Cleticrs — 


LETTER 
Syntax | | | 
{one of the EBCDIC characters, A through z, incase = 


Examples 
| ie 
Q 
Z 
Semantics 


| Whenever the item of (letter) appears in the NDL syntax, one of the 26 6 alphabetic EBCDIC characters 
Bam ae a a ee oa, , OY we : 


Language Components 
CHARACTER | 


(single character) 


SINGLE CHARACTER 
Syntax OO _ * 7 .. * 4G 


a i | any EBCDIC character except the quote (°°) » 
> 4° ( hexadecimal character) > (hexadecimal charac ter) “ 
Examples 


“A” | 
| 4“FF” 


Semantics 


The primary purpose of having a syntactical item of dsingle ehavae ter) in NDL is for use in those faces of — 
syntax TeAUIEINE: an 8-bit character, which can be any combination of bits from “all off? through “‘all on.” 


_ For ease of programming and recognition of usage, the NDL programmer may use either normal EBCDIC 
graphic characters or (hexadecimal character)s to create the needed bit pattern. 


Language Components 


IDENTIFIER — 


IDENTIFIER 
Syntax 
(letter) 


fe ¢ letter): 
~< digit » 


7 Examples 


MINIMIZER | 


| Semantics 


(identifi er) s have no intrinsic meaning. They a are used: to lave symbolic n names to various , definitions in os 
~ NDL. | : | - | 


An (identifier) must start with a (etter , which can be followed bya any combination of ete. s and 7 
(digit)s. te 


The maximum length of an pated is 17 characters. | 


~ Language Components 
- INTEGER © 


INTEGER 
Syntax 


Examples 


0 

37 

Sti 
12345678901 


~ Semantics 


An (integer) is a positive whole number; .e., fractions or rf ractional pane. exponents, etc. are not allowed. 
The maximum integer) allowed i is 99999999999, 
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a Language Components 
LABEL 


LABEL 
Syntax 


sp ee ee a ee = 


Examples 
0 
22 | 
123 
99999999999 | 
Semantics | 


A (jabel) is used to indicate where “execution can branch” within a given (control definition) or (request. 
definition). 7 _ - ee | ia 


(label)s are ‘‘local” in scope; that is, each (Jabel) must be unique only within a given (control definition) 


or (request definition). For example, the (label) 22 could appear more than once in an NDL program so eae 


long as it does not appear more than once in the same (control definition) or (request definition ). Se - 
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- Language Components 
REMARK 


REMARK 

Syntax a 
7o es EBCDIC characters } 
Example oe 
% THIS IS A REMARK 


Semantics 


~ Cremark)s can appear anywhere in the source program. When the compiler encounters the percent sign 


- (%), it skips immediately to the next source record before continuing the compilation process. 
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Language Components = 
SPACE | 


SPACE | 
Syntax 


ERIE ORES SECS vee eee 


{1 EBCDIC sraphic space, hexadecimal 40} , 
Semantics | 


The NDL compiler looks at a contiguous sequence of (spacey s ina source program as a single (space) i. 
(except when contained in a (string) ). Therefore, wherever a single space is allowed, the programmer can _ 


use multiple (space) s to improve readability of the program. 


Language Components 


~ STRING 


STRING 
Syntax 


99 


, {any EBCDIC character except the quote cy} 


| a | (hexadecimal character) hexadecimal character) ~ dies 
Examples 


“THIS IS ASTRING” __ 
“AND” “SO” “IS” “THIS” 
“AND SO”’ 4“C9E2” “THIS” 
4"C2F6F7FOFO” 
“75*4+2/@ (BIG B)” 


Semantics | a | | | 
Only (hexadecimal character) (4-bit) and EBCDIC character (8-bit) (string) s can be constructed. | 
EBCDIC character (string) s are restricted in that they cannot contain the quote (”’) character. 


The maximum allowed length of a (string) is 128 8-bit characters (1024 bits). . 


( 


_ Language Components 


SYSTEM IDENTIFIER 


SYSTEM IDENTIFIER 
Syntax 


Examples 


A 

B6700 

SITE/MCS = 
SYSTEM/RJE/DOWNTOWN 
X/Y/ZEBRA | 


Semantics 


(system iden tifiers have no intrinsic meaning. They are used to give symbolic names to various definitions 
inNDL. A (system identifier) is different from an (identifier) in that it is usually used to reference items 
belonging to the system and not simply to the NDL program. a. on : 


A maximum of 14 (identifier)s, each separated by a slash (/ ), is allowed. 
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Language Components 


TALLY NUMBER 


TALLY NUMBER 
Syntax 


-Examples 


0 
I 
2 


Semantics 


tally number) is required to ona one of the three e dovte variable) TALLYs: for example, 
~ TALLY[O}]. 


Language Components 
TIME 


TIME 
Syntax 


= 
= (integer) 


MIN 
SEC 


> MILLI — 
MICRO 


Examples 


0 

5 MIN 

30 SEC 
200 MILLI 
9 MICRO 


Semantics 


(time) is used to express or define an increment of time. MIN denotes minutes, SEC denotes seconds, 
MILLI denotes milliseconds, and MICRO denotes microseconds. 


The maximum amount of time that can be specified i is 6 minutes 42 seconds. - 
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Language Components 


TOGGLE NUMBER 
TOGGLE NUMBER 
Syntax 
—_—_p-() 
> 2 
3 : 
4 
> 5 
Examples 
; | 
4 
7 
Semantics 


toggle number) is required to designate one of the eight (bit variable) TOGs. For example, TOGI5] a 


Source Program Structure’ 
NDL PROGRAM UNIT 


_ 4, SOURCE PROGRAM STRUCTURE 


NDL PROGRAM UNIT _ 
Syntax 


. (constant definition _ 
—s (MCS definition » , : 


¢ translatetable defini tion \ ie 


(A) : (control definition’ : — . eee | * JS 4 ery 


(request definition’ 3 , <modem definition —— 


(terminal definition ) (station definition) IN, - (line definition) 


(DCP definition ) 


« file definition) 


Source Program Structure 
NDL PROGRAM UNIT | 
Continued 


Examples = 
CONSTANT... 
MCS... - 
TRANSLATETABLE .. 
CONTROL ... 
REQUEST... 
MODEM ... 
TERMINAL ... 
STATION ... 
LINE... 

DCP... 

FILE... 


Semantics 
The NDL source program is divided into 11 program sections ordered as shown. An NDL program 


must include the control and request sections (in any order), and the terminal, station, line, and DCP - 
sections. Each section is described in detail in chapter 5 of this manual. a | 
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DEFINITIONS | 


The NDL definitions, which com 


Section 4, are listed in alphabeti 


corm mo AO op 


CONSTANT 
CONTROL 
DCP 

FILE 

LINE 

MCS 
MODEM 
REQUEST | 
STATION 
TERMINAL 
TRANSLATETABLE 


5. DEFINITIONS 


cal order and described in the same order: 


Definitions | | | 
DEFINITIONS — 


prise the 11 program sections of the source program structure shown in . 


Definitions 
CONSTANT 


CONSTANT DEFINITION 
Syntax 


CONSTANT ——( constant identifier )\—s= L > ( constant identifier ) 


> < string) ———— 
Examples ee 
| CONSTANT NUL=4"00". | 
CONSTANT SOH =4“01 ” STX = 4°02”. | : 
CONSTANT Cl =SOH 4°00” STX, C2 = “123"4“F4a”. 
Semantics | | >: 


The (constant definition) equates each of one or more (identifier) s with a (string). Once that equation is 
made, any subsequent appearance of the Cconstant identifier) is syntactically and semantically equivalent 
to the (string). , : a 


Ifa (constant identifier’ appears after the equal sign, it must have been defined previously in the program. 


Supplementary Examples a 
Examples of Valid Cconstant definition) s = = a 7 F -_ . | —_ a ‘ati | 
Example | | | _— | a, a : 

CONSTANT GREETING = “WELCOME TO B 6700 TIME SHARING.”. . 


This example equates the string) “WELCOME TO B 6700 TIME SHARING.” to the (constant identifier) 
GREETING. | oe : | . * 2 j 


Example 2. 


CONSTANT a . | 
CR = 4“0D”, % A CARRIAGE RETURN _ 
LF = 4°25") %ALINEFEED | | 


_ CRANDLF’ _ =CR LF, % A CARRIAGE RETURN AND A LINE FEED 
DELETELINE = “DELETED” CR LF. % THE STRING “DELETED”, 
| % A CARRIAGE RETURN, AND 


 % A LINE. FEED. 


This example references other constant identifiers)s to define a (constant identifier). (String\s and 


(constant identifier) s may be interspersed to define a (constant identifier). — 
Examples of Invalid (constant definition’ s | 
Example 1 oe 


CONSTANT BADCNST = 4“123”. 


The above (constant definition ) would cause a syntax error to be generated, because the (string is not 
properly formed. The length of the (string ) must be a multiple of eight bits. 


ee. 


Definitions 
CONSTANT | 
— Continued 


Example 2 


CRANDLF = CRLF, % LINE! 

CR = 0D", &LINE2 

LF = 4°25”. % LINE 3 | | | 

This example would cause a syntax error to be generated, because the «constant identifier) s LF and CR are 
referred to in line 1, but not deciared until line 2 and line 3. A (constant identifier) must be declared 
before any reference to that (constant identifier) canbe made. | _ 


Definitions 
CONTROL 


CONTROL DEFINITION 
Syntax 


CONTROL we (control identifier > fim ? 


Be. (error switch statement ) aaa a ener 


7” (assignment statement). 
(break statement) 

= (code statement ). 

- (compound statement ) 
= <continue statement \ | ——o 
= (delay statement) 

> (finish statement) 

= (fork statement) — 

(go 10 statement) 

B idle statement : 

, ( if statement ) 
(increment Statement \ 
: i initialize statement ) . 
i (initiate statement ) 

- (pause statement ) — 

= (receive didteniont) 

> (shift Statement) 

(sum Statement ) 

: transmit statement ) - 


> (wait statement ) 


Definitions 


CONTROL 


Continued 


Examples 


CONTROL CONTENTION: | 
INITIATE REQUEST. 
INITIATE ENABLEINPUT, 
IDLE. 


CONTROL POLL: _ | 
5: IF STATION GTR 0 THEN 
BEGIN | 
10: | STATION = STATION -- 1. 
INITIATE REQUEST. 
INITIATE ENABLEINPUT. 
END. | | 


ELSE 
BEGIN | | 
STATION = MAXSTATIONS. 
GO TO 10. } 
END. 
GOTOS. ~ 


Semantics 


A Ccontrol definition) is an algorithm that describes the allocation of the use of a logical line to the 
stations assigned to that line. Tt is the (costrol definition) that decides if and when a station's Receive 
Request or Transmit Request should be initiated. | ; | 


A single (control definition) must control the logical line resource for all of the stations ona half-duplex 
line. In the case of full duplex, one (control definition) must control the primary line, and onc additional _ 
(control definition) can be designated to control the auxiliary line. (One (control definition) could be 
designated as the control for both the primary and auxiliary lines. If a <controi ite finition) is not desig- 
nated as the control for an auxiliary line, then a default equivalent to an (idle statement.) is. used.) The 
programmer, however, cannot directly define a particular control definition L) for a logical line inits 
line definition). \nstead, for each (terminal definition) , a single (control definition) must be defined. 
(Two (control definitions can be named if the terminal duplex statement) specifies DUPLEX=TRUE.) 
Next, in each (station definition), a (terminal definition ) must be defined for the station (by means of 
the ¢ station terminal statement). Finally, each {station definition ) is assigned to a logical line (in the 
line station statement) of the (line definition )). This last association must be such that each station (i.e., 
station definition)) assigned to the logical line references (indirectly through its (terminal definition) 
the same (control definition) s as every other station assigned to the line. i 


A (control definition) fora given line can deal only with one station at a time. All statements executed | 
apply to and affect only one station assigned to the line. The <control definition) chooses the station | 
with which it wishes to deal by setting the value of the (byte variable) STATION to the chosen station’s 
station index. _ aa 7 | wtac. oe Oe 4 | 


control identifier) has the same syntactic form as (identifier). | a 


The statements in a <control definition) are executed sequentially. In some cases; however, it is desirable 
to alter the order of execution of statements within the procedure. A (control statement) preceded 

by a (label) is one means of accomplishing this. The (go to statement) is used to transfer control to a 
(label)ed (control statement). — rs & Ps ? ee ie : 


Definitions 
CONTROL 


Assignment Statement - 
ASSIGNMENT STATEMENT - 
Syntax | 
FORM 1 - LOGICAL ASSIGNMENT ae 
(assignable bit variable) ———» = (bit variable). ‘ 
> TRUE 
| — > FALSE — 
FORM 2 - VALUE ASSIGNMENT : 
(assignable byte variable \ = (byte variable) 
| | (integer ) + —e (byte variable 
(single character \e) Le — —w) |» ( integer) - 
: (single character) 
eETOetan TG identifier ) —w ( mace byte variable } =) 7 
{ receive “adress.” Statement } ——__ | ~ 
an nad | _ | \/ 
Examples | ar | a 
TOG [0] = TRUE. 
TOG [1] = TOG [0]. 


LINE (BUSY) = FALSE. 
RETRY = STATION (TALLY). 
STATION = MAXSTATIONS. . 


TALLY [0] = STATION (FREQUENCY)-TALLY. [ 1]. 
_ CHARACTER = TRANSTABLEID (CHARACTER). 
STATION = RECEIVE ADDRESS acai [ADDERR: 999]. 


Semantics : 
FORM | 


This form causes the value on the right side of the equal sign to replace the current value of (assignable 
bit variable). | 4 : | ae se : pone 


FORM 2 


Value assignment causes a calculated value on the right of the equal sign to be pelea in the (assignable 
byte variable). Arithmetic calculations are done in modulo 255 arithmetic. 


(assignable byte variable ) = (translatetable identifi er) (Cbyte variable). 


This construct is the means to invoke user-defined character translation. User-defined translation i is 
effected by three areas of the NDL source program. | 


a. Ina (franslatetable definition) the programmer must define the contents ofa translation 
table and associate a (translate table identifi on with it. a 


—. 


‘Definitions 
_ CONTROL 
Assignment Statement - Continued : 


b. Inthe (terminal definition) of a terminal type that requires special character translation. 
the programmer should suppress automatic character translation by using either of the | 


following forms of <terminal code statement): | 
| CODE = BINARY. 
of 
CODE = EBCDIC. 


‘finition), the programmer invokes the translation 
by using this option of the value assignment. Any (byte variable) can be designated as 
containing the character to be translated. | ss 


¢. Ina (control definition) or (request de 


The (translate table identifier) identifies the translation table to be used. An_dassignable byte variable) 
_ 18 designated to the left of the equal sign, identifying where the resulting translated character is to be 
stored. ee: | a 


If N is the “source size) (defined in the <translatetable definition) ), then the N low-order bits of the. 
(byte variable) are used as an index into the translation table. The eight-bit character thus indexed is 
stored in the (assignable byte variable). rr A ee ee oe 

(assignable byte variable) = {receive “address” statemen th. 


This construct attempts to RECEIVE the address characters of a terminal, .~:d store in (assignable byte . 
variable ) the station index of a station whose address characters are equal to those received. The =| 

receive “address” statement } is the same as described in the semantics of the RECEIVE ADDRESS _ 
option of the (receive statement). The optional syntax in the {receive “address” statement} invokes 
the same actions as described in the receive statement ) semantics except for ADDERR. Any action 
specified for ADDERR is taken if no valid station assigned to the line is found with address characters 
equal to those received. | ® SO ee ae et a | 
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Definitions 
CONTROL 
Break Statement 


BREAK STATEMENT =| oO _ Sat 
Syntax | | 

break time) (del one: — 
Examples 


BREAK (*,NULL). | | 
BREAK (200 MILLI, 3 SEC). 
BREAK (*, 3 SEC). 

BREAK (100 MILLI, NULL). 


Semantics 


The (break statement p causes Bley zeros to is transmitted on the line, thus changing the state of the 
line to.a “spacing” condition fora specified time. | | 


(break time) specifies the (time) to break. An asterisk indicates that a standard break of 2 character | 
times should be used. | , | . , 


(delay ‘time, ie the (time). to delay subsequent t to the break and prior to when control. ee "38 a 


continues. 
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Definitions | 
CONTROL _ 
(ude Statement 


ed 
CODE STATEMENT 
Syntax 
CODE ——_—> = - in 
Semantics 


CODE=ASCIHI invokes the ASCII-to-EBCDIC translation for received data and the EBCDIC-to-ASCII 
translation for transmitted data. | : | | 7 


CODE=BINARY inhibits any character translation on data transmitted or received. — 
Pragmatics | _ 


_ The (code statement) allows a programmer to either invoke or inhibit on a logical line the DCP ASCII-to- 
EBCDIC character code translation for input, and the EBCDIC-to-ASCII character code translation for 
output. Any (erminal definition) that names, in its (terminal control statement), a (control definition) 
that utilizes the (code statement), must define ASCII(BINARY) as its character code in the (terminal 
code statement). (Refer to the (terminal code statement) in this chapter.) = a | 


inhibited. If translation is inhibited, translation will be inhibited on that line until invoked again by execu- 
tion of CODE = ASCIL or if control is transferred to a (request definition) which executes one of the . 
oe following: CODE=ASCII, TERMINATE NORMAL, TERMINATE LOGICALACK, TERMINATE _ 
tl LOGICALACK(RETURN), TERMINATE ERROR, TERMINATE ENABLEINPUT, or (while executing a 
Receive Request) TERMINATE NOINPUT. a aan rr | 


Once that translation has been invoked on a logical line, the translation continues until such time that it is | 


Detinitions 
CONTROL 


Compound Statement 


COMPOUND STATEMENT 


Syntax 


BEGIN 


Examples 


BEGIN 


INITIATE TRANSMIT. 


(control statement ) END —————___________» . 


% EXAMPLE 1 


TRANSMIT EOT. 
FINISH TRANSMIT. 


END. 


IF STATION (VALID) THEN 


IF § 


Semantics 


The ¢compour 
more than one 
must be used. 


TATION (READY) THEN ma 
BEGIN © ar % EXAMPLE 2 
INITIATE TRANSMIT. | 
TRANSMIT “ON THE AIR”, 

FINISH TRANSMIT. 
END. 


rl Statement) groups several statements together to form a logical sequence. To execute | 
statement when the condition of an (if statement) is satisfied, a «compound statement) — 


Definitions 
CONTROL 


Continue Statement 


CONTINUE STATEMENT 
Syntax 


CONTINUE —————— ——_ . 
Semantics 

The (continue statement’ can appear in only those (control definition) s and request definitions 
written to communicate with full duplex terminal types. This statement causes the co-line to resume 
processing, if, and only if, it had been suspended by a (wait statement) ora (receive statement) witha — 


CONTINUE option specified. If the co-line had not been suspended, this statement acts as a no-op. The 
(continue statement) has no effect upon the line on which it was executed. — 4, 


Pragmatics 


Refer to the (fork statement) pragmatics. 


| Definitions 
CONTROL 
Delay Statement 


DELAY STATEMENT 
Syntax 


DELAY ————_—_____»  ( (delay time)» ) ee. 


Example 
DELAY (10 MICRO). 
Semantics 


The (delay Statement) provides a means to delay a specified period of time before control proceeds to the 
next statement. The (control definition) is suspended in a “sleep” state for the (delay time) specified. 


Pragmatics | | _ a — 
The “sleep” state induced by the delay statement) allows the DCP to service Cluster Attention Needed 
(CAN) interrupts for other logical lines. - , Ss | 
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Definitions 
CONTROL | 


| Error Switch Statement 


ERROR SWITCH STATEMENT 
Syntax 


ERROR— > [ —& ( switch number ) —e | —> = 


Examples 


ERROR [0] = BREAK:0,BUFOVFL:NULL,LOSSOFCARRIER:ABORT 
PARITY :999, STOPBIT:999, TIMEQUT:NULL. 

ERROR [1] = BREAK:NULL. 

ERROR [99] = BUFOVFL:NULL . 


Semantics 


The Ce rror switch statement) is a non-executable statement that allows the programmer to define a 
set of default actions that are to be taken in a (receive statement) if tie. ee errors occur. 


(switch number) has the syntactic form of (integer). 


BREAK 


The BREAK option variations cause actions as described if a break, that is, at least. 2 character-times of | 
a spacing line condition, is detected by the adapter cluster while receiving: 


BREAK:NULL : causes no action. Execution proceeds as if the break did not occur. — 

BREAK: (/abel) _ a sha the (bit variable) BREAK[RECEIVE] and branches control 
_ to Clabel 

BREAK: ABORT sets TRUE the (bit variable) BREAK [RECEIVE], and executes an 


implicit TERMINATE ERROR. 
BUFOVFL | 


The BUFOVFL option variations cause actions as described if the DCP is unable to service a cluster 
Attention Needed (CAN) interrupt pelone the ieapter Cluster receives another character (thus. destroying 
the previous character): . | 


BUFOVFL:NULL causes no action. Execution proceeds as if the error condition did not 

: | occur. 
BUFOVF L: (label) sets TRUE the bit variable) BUFOVEL, and branches control to (‘abe ». 
BUFOVFL: ABORT sets TRUE the (dit variable) BUFOVFL, and executes an implicit 


a ERROR. | 
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Defintions 
CONTROL 


Error Switch Statement -- Continued 


LOSSOFCARRIER 


The LOSSOFCARRIER option variations cause actions as described if a loss of carrier is detected while 
receiving. | | : | 


LOSSOFCARRIER:NULL ~ causes no action. Execution proceeds as if the error 
ee | did not occur. re + ae 
LOSSOFCARRIER: CJabe!) sets TRUE the (bit variable» LOSSOFCARRIER, and 
| branches control to (/abe/). | 
LOSSOFCARRIER: ABORT sets TRUE the (bit variable) LOSSOFCARRIER, and 


executes an implicit TERMINATE ERROR. | 


There is one exception to the actions described above. If a loss of carrier is detected while receiving, and 
if the terminal is modem-connect, and if the terminal’s ¢ station definition) references a ( modem 
definition) that contains the statement LOSSOFCARRIER=DISCONNECT, then an implicit disconnect 
is done, regardless of the action associated with LOSSOFCARRIER in the error switch Statement). 


PARITY 


The PARITY option variations cause actions as described if a parity bit error is detected by the adapter 
cluster: | | att 


PARITY :NULL : causes no action. Execution proceeds as if the error did 
| - not occur, 7 | - | 
PARITY: Gabel) iy TRUE the (hit variable) PARITY, and branches control 
to (abel). 73 a | : 3 
PARITY: ABORT 7 sets TRUE the (ir variable) PARITY , and executes a 
TERMINATE ERROR. | , os 
STOPBIT ‘ 


The STOPBIT option variations cause the described actions if a stop bit error is detected by the adapter 
cluster: | | 


STOPBIT:NULL ; causes no aeons Execution proceeds as if the error did 
| not occur. | > 7 7 
STOPBIT: (/abel) | | ie ae the (dit variable) STOPBIT, and branches control 
| : to(labelp. 
STOPBIT: ABORT sets TRUE the (hit variable) STOPBIT, and executes a_ 
| oe TERMINATE ERROR. | 
TIMEOUT | | _- 


The TIMEOUT option variations cause the actions described if the time required to receive a character 
exceeds the (timeout time). The (timeout time) is defined in the (terminal timeout statement), — 
but can be overridden by including the (( timeout time) or (NULL) syntax options in the (eceive 
statement). r ot 


TIMEOUT:NULL causes no action. Execution proceeds as if the error did 


| not occur. a CU Dee | a | 
TIMEOUT: ¢ label) sets TRUE the ¢ bit variable) TIMEOUT, and branches 
ss control to ¢ label). — ; | | 
TIMEOUT: ABORT _ sets TRUE the (hit variable) TIMEOUT, and executes a 


TERMINATE ERROR. | 


S—14 


Definitions 
CONTROL 


_ Error Switch Statem: -t — Continued 


Pragma tics 


An Cerror switch Statement) must be associated with a (receive statement) by means of a (switch number) 
reference before any of the default actions will be invoked. The (error switch statement) can appear ina 
(control definition) as many times as the programmer deems convenient providing the following | 
restriction is observed: Within a given (control definition’, (error switch statement) s must have a 

unique (switch number), and all (error switch Statement) s must precede all executable statements in the _ 
procedure. ; | | | : | | | 
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CONTROL 


Finish Statement 


FINISH STATEMENT 


Syntax 


FINISH ———» TRANSMIT 


i SNE 
( delay time 5 + 
Examples | 


FINISH TRANSMIT. 
FINISH TRANSMIT (NULL). 
FINISH TRANSMIT (3 SEC). 


Semantics 


The purpose of the ¢ finish statement) is to take a line out of the transmit ready state and prepare the line 
to receive information. The adapter cluster delays a period of time long enough for the last character 
TRANSMI7Tted to be transmitted, plus 2 milliseconds, before the line is put in a receive ready state. Al- 
though the 4 finish statement) puts the line in a reccive ready state, the cluster hardware invokes a delay 
that inhibits any data from being received for 25 milliseconds. An INITIATE RECEIVE construct should 
precede any subsequent ¢ receive statement) , to override the 25 miliisecond hardware delay. 


The (delay time ) option allows the programmer to specify a software delay of (time) before execution 
continues in the (control definition). | 


For example, the statement 
FINISH TRANSMIT (3 SEC). 
is equivalent to | 


FINISH TRANSMIT. 
DELAY (3 SEC). 


The FINISH TRANSMIT (NULL) construct is equivalent to FINISH TRANSMIT, 
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i ork Statement 


FORK STATEMENT 
Syntax 


FORK ——$$ bel) - 


Example 
FORK 10. 
Semantics 


The (fork statement) is.allowed in only those (control definition) s and (request definition) s that.are 
written to communicate with full duplex terminal types. This statement can be executed in the — 

Ccontrol definition) or (request definition) of the auxiliary line or the primary line. The execution of this 
Statement causes the co-line control, if not busy, to branch to and begin cxecuting code in the ¢ control 
definition) that executes the FORK at the ¢ lubel specified, while control on the FORKing line executes 
an implicit PAUSE (i.c., a (pause statement )) and continues executing in parallel. The co-line is determined 
busy or not busy by testing the BUSY bit (i.c., LINE(BUSY) or AUX(LINE(BUSY)), whichever is appro- 
priate). If the co-line is busy, the ¢ fork statement ) acts as a no-op. 


Pragmatics 


Synchronization problems can occur between the primary and auxiliary lines as a result of the (fork 
statement ) executing the implicit PAUSE. The implicit PAUSE yiclds use of the DCP, to allow processing to 
proceed on other lines. Thus, processing on the co-line is actually started before the FORKing line exits 

the ( fork statement). As a result, the programmer must, by some means (e.g., by setting and testing line 
TOGs), effect the synchronization of the lines. This is especially critical if the code contains ¢ wait 
statement)s and (continue statement)s. The following example illustrates how full duplex lines could 
“hang” as a result of poor synchronization. 


FORK 10. 
WAIT. 


10: | CONTINUE. 
WAIT. 


Assume that the primary line executes the FORK 10. At that point, the primary line temporarily yields 
use of the DCP to other lines. The auxiliary line starts up and executes the CONTINUE. Since primary 
control is still at the (fork statement) and is not in a (wait statement) , the auxiliary line CONTINUE acts 
as a no-op. Next, the auxiliary line executes the WAIT. When the primary line is given use of the pro- 
cessor again, it executes its WAIT. At this point, the primary and auxiliary lines are “hung,” each WAITing 
for a CONTINUE from its co-line. | 


Definitions \ 
CONTROL 
Go To Statement 


GO TO STATEMENT 


Syntax 


(b y te mT - C ah i 


Examples 
GO 10. 
GO TO 10. : 


GO TO TOGS, (0, 1, 2, 3). 
GO TO STATION (5, 9, 12). 


Semantics 


The (80 f0 statement) alters the path of control, that is, the sequential flow of statement execution, within 
a (control definition). 


GO TO (label) 


This form of the (go to statement) unconditionally transfers control to the (label. specified. 
GO TO (byte variable’ . .. | 


This form of the (go to statement) provides a convenient means of dynamically selecting one or more 
(labels to which control could branch. The (label) to branch to is selected by using the (hvte variable ) 
as an index value. If N represents the number of (labels in the (go to statement), then the (label)s are 
numbered 0 to N-L. The (/abel) corresponding to the index value is the (label) to which control 
branches. If the index value is greater than N-1, then control continues at the statement following the 
(go to statement, : 


Supplementary Example 


GO TO STATION (5, 9, 12). 
Yo EXECUTION CONTINUES HERE IF STATION > 2. 


5: TOG [0] = TRUE. 
9: TOG [1] = TRUE. 


12: TOG [2] =TRUE. | = 


5-18 


is ny. el 


~ © OPROL 


Go To Statemen: ‘“‘ontinued 


This example illustrates the “GO TO (byte variable) .. .” option of the (go to statement). The value of - 
STATION determines the next statement to be executed. If the value of STATION is G, control branches 
to the (/abe?) 5; if the value of STATION is 1, control branches to (/abel ) 9; and if the vaiue of STATION 

_ ds 2; cofitrot branches to (label 12. If the value of STATION is greater than 2, control continues at the 
next séquential statement. 


Sogaer. Js 5 Se ate. Aron ‘ a ee 
fe ae Uae AY Spo a, areata ot an . 
Pr re oe Ao . re 


i” a 
gia £ Se y, ae 
a ata eae ee | teh 3 
+ a RS 
i woe i aren | 
ata: if, Tip lis 
ee) + ott has 
‘ a ay: 
ee be 
" 

oof . 


| ‘ - el rn re ee yy i 
Definitions | i ce OS 
re eacy® 


CONTROL ,**** 
Idie Statement 


IDLE STATEMENT 
Syntax 


a 


Semantics 


The execution of the \idle statement) causes a logical line to be suspended in an idle state. Specifically, 
IDLE causes the LINE(BUSY) (bit variable) to be set FALSE, the line to be Suspended ina a and 
“ready” status, and all subsequent inbound data to be discarded. 


Pragmatics 


The Cidle statement) suspends the execution of a (control definition) for'a logical line. Normally, this 
statement should be executed only when there are no outbound messages queued for any stations on the 
line and none of the stations on the line are ENABLED for input (or possibly, if the programmer wants any 
available inbound data discarded). Consider the following example of the contention-type (control 
definition) taken from the Burroughs SYMBOL/SOURCENDL program. — 


CONTROL CONTENTION: © 


INITIATE REQUEST. 
INITIATE ENABLEINPUT. 
IDLE. 


In this example, DLE is executed only after it h: “is been determined (by means of INITIATE REQUEST 
and INITIATE ENABLEINPUT) that the station is not QUEUED and not ENABLED for input. 


Once a tine ts in an tdle state, pone line remains in an idle state until one of the following circumstances 
OCCULS: 


a. If the line TYPE is DIALIN and the line becomes connected (as a result of ANSWER = TRUE 
in the Cline definition) ,a DIALOUT (TYPE = 98) DCWRITE from the MCS, or an ANSWER THE 
PHONE (TYPE = 100) DCWRITE from the MCS), the cain definition) is initiated for the 
line. 


b. If any of the following station-oriented DCWRITEs are executed for any station assigned to the 
line, then the (control definition) is initiated for the line. 


ENABLE INPUT (TYPE = 35) | 

DISABLE INPUT (TYPE = 36) 

SET CHARACTERS (TYPE = 39) 

SET TRANSMISSION NUMBER (TYPE = 40) 
SET/RESET LOGICALACK (TYPE = 43) : 
NULL STATION REQUEST (TYPE = 48) 
SET/RESET SEQUENCE MODE (TYPE = 49) 


c. Ifa WRITE request or a READ request is found in the DCP’s Request Queue (placed there as a 
result of the MCS executing a WRITE (TYPE = 33) DCWRITE or 2a READ-ONCE ONLY : 
(TYPE = 34) DCWRITE, or the 1/O intrinsics) for a station on the line, then the appropriate a 
(request definition) is initiated for the line. | 


ae ae 
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If Statement 


IF STATEMENT 
Syntax 


IF TRUL —— rs err 
NOT FA =— . | 
dbit variable) . 


(hvte variables 


control statement) > ELSE © Control statement) 4 


LSS 7 (brte variable) 


(integer) LEQ integer) — 


(single character) EQL (single character) a! 


Examples 
IFTRUETHEN. | | 
IF TOG[0] THEN TOG[0] = FALSE. | 
IF TALLY[0] LSS TALLY[1] THEN TALLY[0] = TALLY[1]. 
IF CHARACTER= 4“FF” THEN © - 


_ INITIATE BREAK. 
ELSE | ; 
BEGIN | 
CHARACTER = 400”, 
GO TO 0. 3 


IF STATION(READY) THEN 
IF STATION(QUEUED) THEN 
LINE (TOG[0] ) = TRUE. 


GO TO 10.. 
ELSE IDLE. 
Semantics 


The Gf statement) causes a condition (i.e., a Boolean expression) to be evaluated. The subsequent path of 
program control depends on whether the condition is evaluated as TRUE or FALSE. 


If the condition is TRUE, the (control stat ement) following the THEN, if present, is executed. Program | 

control then resumes at a statement that follows the (if statement). - 

If the condition is FALSE, the 
control statement) is omitted 

Cut statement). 


(control statement) following the ELSE is executed or,.if the ELSE 
» Program control resumes at the (control statement following the 
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Definitions _ 
CONTROL 
If Statement — Continued 


The (control statement) can be any legal (control statement), including the if statement) and 
“compound statement). The meanings of the relational operators are contained in table 5-1. The follow- 
ing diagrams illustrate the (if statement) semantics. | | 


TRUE | 
IF {condition t THEN (control statement) {control statement ) | 
FALSE—— 


TRUE | 
IF {condition } THEN (control statement) ELSE (control statement) (control statement ) 
FALSE | 


Table 5-1. Relational Operators 


RELATIONAL OPERATOR | _ MEANING SYNONYMS 


LSS : | : Less than | <and LS —~ 
LFQ | Less than or equal to | LE = 
EQL | | Equal to | | | = and EQ 

NEQ — Not equal to NE 

GEQ | Greater than or equal to | | GE 

GTR | ee Greater than | oe sand GT | 
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INCREMENT STATEMENT 
Syntax . 
INCREMENT ——™ SEQUENCE eer nC | oe 
— Le sSEQERR—»:—J Le (/abe1) — | 
Examples | 
INCREMENT SEQUENCE. 


INCREMENT SEQUENCE [SEQERR: NULL]. 
INCREMENT SEQUENCE [NULL]. __ 
INCREMENT SEQUENCE [999]. 


Semantics 


The (increment statement) causes the sequence number stored in the DCP Station Table to be increased by 
the value of the increment (also stored in the DCP Station Table), providing that the station is in sequence 
mode; otherwise, this statement is a NOsOp. | | —_ ee | 


When using the INCREMENT SEQUENCE construct, provision should be made for taking action if the 
increment caused the sequence number to exceed ( erflow) the size of the sequence number field. The 
programmer can take such action by including the optional syntax. Failure to include overflow action 


results in an implicit TERMINATE ERROR if an over Ow occurs. 


The SEQERR:NULL and NULL options are semantically equivalent. These options set the SEQERR 
(bit variable) TRUE, and control continues at the next \squential instruction: | 


The SEQERR: (label) and (label) options are semantical\y equivalent. They cause the SEQERR ¢bit 
variable) to be set TRUE, and control to branch to (/abel\. } es | 


/ 


Regardless of whether error action is specified or not, an ovtrflow of the sequence number field destroys : 


the contents of that field. 
Pragmatics 
SEQUENCE MODE 


A station is considered to be in sequence mode whenever its SEt UENCE (bit variable) toggle is TRUE. 
SEQUENCE can be set TRUE only as a result of the controlling \{CS executing the SET/RESET | 
SEQUENCE MODE (TYPE = 49) DCWRITE. In addition, the T\PE 49 DCWRITE also stores the starting 


sequence number and increment in the appropriate fields of the L'CP Station Table. 


Sequence mode can be used for any application that the NDL prog \\mmer may see fit. Its use, however, 
requires Common conventions between the NDL programmer and tl\: MCS programmer. Burroughs has 
utilized sequence mode constructs in two (request definition) s of S\MBOL/SOURCENDL: __. 
READTELETYPE and WRITETELETYPE. Both require the coopera\on of SYSTEM/CANDE to effect 
the execution of those statements. The reader is referred to those <req ost definition) Ss as an example of a 
particular application that Burroughs has implemented. Other statemen\ relative to sequence mode are the 
(transmit statement) (TRANSMIT SEQUENCE construct) and the (stor\ statement) (STORE SEQUENCE 
construct). | : ee : | | re : | | oo 
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Initialize Statement 


INITIALIZE STATEMENT 
Syntax 


, CRC mt | 


Examples 


INITIALIZE BCC. 
INITIALIZE CRC. 
INITIALIZE RETRY. 


Semantics 


INITIALIZE BCC 


The INITIALIZE BCC construct causes the (byte variable) BCC to be initialized for purposes of 
accumulating a Block Check Character. The value to which BCC is initialized is dependent upon the 
horizontal parity defined for the station’s associated (terminal definition) (in the (terminal parity 
statement) ). If horizontal parity is defined as HORIZONTAL:ODD, then BCC is initialized to all ones 
(i.c.,4°FF”’). If defined as HORIZONTAL: EVEN, then INITIALIZE BCC initializes BCC to all zeroes 
(i.c., 4°°00"’). | | | 


INITIALIZE CRC 


The INFFLALTZE CRC construct initializes CRC to the initial value required for calculating the | 
Cyclic Redundancy Check. Any terminal definition) referencing a control definition) (in the terminal 
control statement) ) that contains this instruction must define the horizontal parity (in the terminal parity 
statement) ) as HORIZONTAL:CRC(16); otherwise a syntax error is generated. 


INITIALIZE RETRY 


The INITIALIZE RETRY construct causes the value stored in DCP INITIAL RETRY to be stored in DCP 
RETRY. | | | | 
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INITIATE STATEMENT 
Syntax 


INITIATE 


RECEIVE 


TRANSMIT —— 


} 


REQUEST 


a a 
(delay time’ 


t 
| 
é 


ENABLEINPUT 


BREAK ow 


! 


Examples | 


INITIATE RECEIVE, , | 
INITIATE TRANSMIT (3 SEC). | 
INITIATE REQUEST (NULL). 

_ INITIATE ENABLEINPUT, 
INITIATE BREAK. 


Semantics i { 
: p 
INITIATERECEIVE _—_/ 1 


The INITIATE RECEIVE const ict causes t| e adapter cluster to initiate a receive delay calculated for the 
station. After the delay, the ha/!ware is realy to receive information. i | | 
: , | 


The amount of time delayed, s/ferred ho as the Initiate Receive delay, is unique to each station and is cal- 
culated at compile-time for e/- station. The algorithm that the compiler uses to calculate the Initiate 
Receive delay is described j/” the follc}wing three paragraphs. 


_ 
a. If the (modem /2finition rfferenced in the (station definition) (in the (station modem statement) 
defines the m,/.em NOISEDELAY as being greater than zero, then the Initiate Receive delay is 
2 millisecong less than the combined ¢time)s defined in the (modem noisedelay statement) and 
the (mode/ transmitdelay statement). a | | 


b. If the m/iem NOISEDELAY is defined as zero and the modem TRANSMITDELAY is defined as 
being I ‘; than 7 milliseconds, then the Initiate Receive delay is zero. : | 


-c. If th/:nodem NOISEDELAY is defined as zero and the modem TRANSMITDELAY is defined as 
bein equal to or greater than 7 milliseconds, then the Initiate Receive delay is the lesser of 
15 7-illiseconds or (1.5 milliseconds + modem TRANSMIT DELAY). | 


} tg option or the (delay time) option can be used to override the calculated Initiate Receive delay. 
f mediately readies the hardware so that it can receive information. (delay time) specifies a (time) 
ed in place of the Initiate Receive delay. a 


Definitions 
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Initiate Statement — Continued 


Pragmatics 


An INITIATE RECEIVE instruction should precede the first (receive statement) following a transmission. | 


If it does not, there is a possibility that execution of the (receive statement) will be delayed for a period 
of time of up to 25 milliseconds. The cause of the 25-millisecond delay is described under the semantics 
of the (finish statement). - : 

INITIATE TRANSMIT 


The INITIATE TRANSMIT construct causes the Adapter Cluster to be put in a transmit state after a cal- 
culated delay. The amount of time delayed is referred to as the Initiate Transmit Delay, and is unique to 


each station. It is derived by taking the greater of the NOISEDELAY (time) specified for the modem con- 


figured at the system end, or the TURNAROUND <time) specified by the station’s associated (terminal 
definition) . This construct must be executed prior to any attempt to transmit information. 


The NULL option or the (delay time > option can be used to override the calculated Initiate Transmit 
delay. NULL causes the adapter cluster to be put in a transmit state immediately. ¢ delay time) specifies 
a (time) to be used in place of the Initiate Transmit delay. : 


INITIATE REQUEST 


The INITIATE REQUEST construct conditionally initiates the next function as indicated by the message | 


at the head of the Station Queue. The initiation of the function is conditional, subject to the following: 
the station must be valid, ready, and queued. Specifically, STATION(VALID), STATION(READY), and 
STATION(QUEUED) must be TRUE; otherwise, the instruction acts as a no-op. | , 


The specific function invoked by this construct is dependent upon the type of message at the head of the 


Station Queuc. Most commonly the message is a WRITE (TYPE=33) DCWRITE, thus causing the Transmit — 


Request for the station to be entered. A READ-ONCE ONLY (TYPE=34) DCWRITE message at the head 
of the Station Queue would cause control to enter the Receive Request for the station. Other messages 
(unrelated to input or output) invoke their specific function and then transfer control to the beginning of 
the (control definition). For example, a SET SEQUENCE MODE (TYPE=49) DCWRITE message wouid 
cause control to enter the subroutine of the DCP that handles setting sequence mode and, when finished, 


control would be transferred to the beginning of the (control definition). 


The (delay time) option allows the programmer to specify that an implicit ( delay statement) for the | 


(time) specified, be executed before initiation of the next function from the Station Queue. For example, | 


the statement 
INITIATE REQUEST (3 SEC). 
is equivalent to 
IF STATION(VALID) THEN 
IF STATION(READY) THEN 
IF STATION(QUEUED) THEN 
BEGIN | 
DELAY(3 SEC). 
INITIATE REQUEST. | 
END. 


The INITIATE REQUEST (NULL) construct is equivalent to INITIATE REQUEST. 
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INITIATE ENABLEINPUT 


The INITIATE ENABLEINPUT constrict conditionally transfers control to the receive request appropriate 
for the station (that is, the station referenced by the (byte variable) named STATION). The transfer of 
control is conditional, subject to the following: the station must be valid, ready, and enabled for input. 
More specifically, STATION(VALID), STATION(READY), AND STATION(ENABLED), must be TRUE; 


otherwise, the instruction acts as a no-op. ” 


The NDL programmer can initially enable a station for input by means of the (station enableinput | 
statement). Additionally, after DCP initialization, the station’s MCS can enable or disable the station for | 
input by means of the TYPES 35 and 36 DCWRITEs. 


(NULL) and ((delay time )) allow the programmer to. specify that an implicit (delay statement), for time — 
specified, be executed before the transfer of control. (delay time) has the syntactic form of time). For 
example, the statement | | | | 


INITIATE ENABLEINPUT (3 SEC). 
is equivalent to: | | | 
IF STATION(VALID) THEN 
IF STATION(READY) ‘THEN _ 
_ IFSTATION(ENABLED) THEN 


BEGIN 

DELAY(3SEC). © 
INITIATE ENABLEINPUT. _ 
END. Oo 


The (NULL) option specifies zero delay. 
INITIATE BREAK | 


The INITIATE BREAK construct causes binary zeroes to be transmitted on the line, thus changing the 
state of the line to a “spacing” condition. The line remains in the spacing condition until some subsequent 
construct causes the adapter cluster to change the state of the line. Constructs that would change the 
line’s state are INITIATE TRANSMIT, INITIATE RECEIVE, FINISH TRANSMIT, BREAK, and IDLE. 
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Pause Statement 


PAUSE STATEMENT 
Syntax 


AUS a 


Semantics . 


The (pause statemen f) suspends a (control definition) ina “sleep” state for a minimum period of time 
(200 microseconds for the B 6358 Model II DCP, and 6 microseconds for the B 6350 Model I DCP) to allow 
the DCP to service other lines. It is recommended that a (pause statement) be used in any kind of loop 
that would tie up processor time and thereby prevent the servicing of other lines. The failure to do so 
results in a high number of timeout faults. a | 


Pragmatics 


Instances may occur in which the DCP requires an even greater period of “‘sleep” to service other lines. 
Repeated timeout faults, despite utilization of the (pause statement) , are indications of such conditions. 
A greater period of “sleep” time can be effected by means of a (delay statement) , with the (time) speci- 
fied greater than “sleep” time effected by the (pause statement). | : | 


Yee 
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Receive Statement 


RECEIVE STATEMENT 
Syntax 


RECHIVEs Se 
ie NULL -———--) 


ae 
we /tineoul ames 


ADDR ~~ tes a 
PE RECEIVE yo): 


| 
Le TRANSMIT- 


: | | ioe oe |-m sirch mumber) | — . e 
LOWED NUP ee 


ADDERR —-~-——~-- 


BCC ——-——---—-—-----— — .- -.--- 


CHARACTER— San EERE ot 1 


CRC Senet a 
TRAN en 
) € string ) Beast ae oes : a 


a (single character) ~ - 


Examples 
RECEIVE. 
RECEIVE CHARACTER. _ | | 
RECEIVE (3 SEC) ADDRESS (RECEIVE) [0, ADDERR:10]. 
RECEIVE (NULL) [ | 


PARITY:999, 
LOSS OF CARRIER:999, 
END, 
~ WRU:NULL 
i _ | 
RECEIVE CRC [ERROR [1], CRCERR:10]. — 
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Semantics 


The (receive statement) causes the adapter cluster to attempt to reccive information from the ap;ropriate 
logical line. 


The following two syntax items define a maximum amount of time that the adapter cluster should wait for 
receipt of the first character, and then each subsequent character, if applicable, before assuming that the 
terminal has “timed out.” If neither of these options is included; the (timeout time) defined (in the 
<terminal timeout statement) ) for the station’s terminal defi inition) is implicitly used as the {timeout 
timé) in this statement. 


(NULL) 
This option specifies that the adapter cluster should wait an infinite amount of time. 
( (timeout time)) | 


The (timeout time) defines a (time) that the adapter cluster should wait for a character. If this (time) is — 
exceeded before receipt of a character, and the TIMEOUT syntax appears, then the action specified for . 

TIMEOUT is taken (refer to TIMEOUT). If the (timeout eg is exceeded and TIMEOUT syntax does not — 
appear, an implicit TERMINATE ERROR i is executed. 


The following syntax options define the nature of the information to be received, the amount of informa- 
tion to be received, and how the information is to be handled. If these options are omitted, it is semanti- 
cally equivalent to specifying CHARACTER (i.e., “RECEIVE.” is semantically eqivalent to “RECEIVE 
CHARACTER.”’) 


ADDRESS 


The proper number of address characters (as defined by the station’s (terminal definition) in the (erminal 
address size statement) are received and checked for agreement against the actual address characters 
defined in the (station address statement). If the address characters do not correspond, an address error 
condition results . If the ADDERR syntax appears then the specified action is taken; otherwise, an implicit 
TERMINATE ERROR is executed. (Refer to the ADDERR semantics.) 


ADDRESS (RECEIVE) 


This option is equivalent to ADDRESS, except that ADDRESS (RECEIVE) must be used when an address 
pair is defined in the (station address statement) ang the programmer needs to check for the proper 
receive address. | oo 


ADDRESS (TRANSMIT) 


This option is equivalent to ADDRESS, Sent that ADDRESS (TRANSMIT) must be used when a an address 
pair is defined in the (station address statement) and the prostammers needs to check for the proper 
transmit address. 


BCC 


One character is received and checked against the (byte variable) BCC. If the character received and BCC 
are not equal, a Block Check Character error condition results. If the BCCERR syntax appears, then speci- 
fied action is taken; otherwise an implicit TERMINATE ERROR is executed. . 


Presumably, if the RECEIVE BCC instruction appears, the programmer has defined horizontal parity in the 
(terminal parity statement), and the accumulated Block Check Character is contained in BCC. 
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CHARACTER 
One character is reccived and stored in CHARACTER. _ 
CRC a 


Two characters are received. The first character is checked against CRC[0], and the second compared 
against CRC[1]. If the characters received and CRC are not equal, a Cyclic Redundancy Check error: 
condition results. If the CRCERR syntax appears, then specified action is taken; otherwise an implicit 
TERMINATE ERROR is executed. © — | | | 


Presumably, if the RECEIVE CRC construct appears, the programmer has defined horizontal parity — oe 
HORIZONTAL:CRC(16) in the (terminal parity statement), and the Cyclic Redundancy Check is contained 
in CRC[O] and CRC[1]. a | 4, eo fone 


FRAN 


The proper number of transmission number characters (as defined by the station’s associated (terminal 
definition) in the (terminal transmission number length statement)) are received and checked for agree- 
ment with the Receive Transmission Number maintained in the DCP Station Table. If the characters 
received and the Receive Transmission Number are not equal, a transmission number error results. If the - 
TRANERR syntax option appears, then specified action is taken: otherwise, an implicit TERMINATE 
ERROR is executed. | _ —— 3 , | aa | 


(string \ 


The number of characters as indicated by the length of the (string) are received and checked against those 
characters in the (string). If the (string) and the characters received are not equal, then a format error 
condition results. If the FORMATERR syntax option appears, then that action is taken; otherwise an im- 
plicit TERMINATE ERROR is executed. . ? : 


The following syntax options specify actions to be taken upon either the receipt of defined characters or 
occurrences of specific error conditions: - : :, ees 


ERROR[ (switch number) | 


Associates a previously defined Error Switch with the (receive statement). This allows the programmer to 
associate a set of previously defined error actions with the <receive Statement) , thus reducing the amount 

of coding required for each (receive statement). BREAK, BUFOVFL, LOSSOFCARRIER, PARITY, | | 
STOPBIT, and TIMEOUT syntax options are not allowed if the ERROR|[ (switch number) | syntax appears: 
in the (receive statement). Refer to the error switch statement) for more information. - | 


(switch number) 


Semantically equivalent to ERROR[ (switch number) J : 


5—31 


Receive Statement — Continued 


Definitions 
CONTROL 


~ADDERR 


The ADDERR option variations cause the followiiee actions if an address error is detected when attempting 
to receive the address characters of a terminal: 


ADDERR 
ADDERR:NULL 


ADDERR: (label) 
ADDERR: ABORT 


BCCERR 


sets TRUE the ADDERR (bit var iable) and branches control to the next 
Sequential statement. 


"causes no action. Execution proceeds as if the e etror condition did not | 


occur. 


sets TRUE the ADDERR bit variable) 3 and branches control to abel, 


Not allowed. 


The BCCERR option variations cause the following agHons if the character received is not equal to the 
data stored i in BCC. 


BCCERR 


BCCERR:NULL 


BCCERR: (/abel) 
BCCERR: ABORT 


BREAK 


sets TRUE the (bit variable) BCCERR, and branches control to the next — 


sequential statement. 


causes no action. pxece tion spoceeds; as if the error r condition did not 
occur. | 


sets TRUE the (bit variable) BCCERR and branches control to (abel, 
Not mee: 


The BREAK option variations cause the following actions if a break, that is, at least two character-times 
of a spacing line condition, is detected by the adapter cluster while receiving: 


BREAK 


BREAK:NULL 
BREAK: (/abel) 


BREAK:ABORT 
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sects TRUE the (bit variable) ian cariaialae and branches control” 


to the next sequential statement. 


Causes no action. Execution proceeds as if the break did not occur. 


sets TRUE the (bit variable) BREAK [RECEIVE], and branches control. 


to (label). 


sets TRUE the ( bit variable BREAK[RECEIVE], and executes a an 
implicit TERMINATE ERROR. 
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_BUFOVFL 


The BUFOVFL option variations cause the following actions if the DCP is unable to service a Cluster _ 
Attention Necded (CAN) interrupt before the adapter cluster receives another character (thus — 
ing the previous character): | , _ | | 


BUFOVFL — sets TRUE the (bit variable) BUFOVEL, and branches control to the next — 
| | sequential statement. | 

BUFOVFL:NULL . ._ causes no action. Execution proceeds as if the error condition did not | 
9s occur. | | | | 

BUFOVEL: (label) sets TRUE the «it variable BUFOVEL, and branches control to | 

rea: label). | 
BUFOVFL: ABORT sets TRUE the bit marily BUFOVFL, and executes 2 an n implicit 2 
| — . TERMINATE ERROR. | 
‘CONTINUE — 


This option is allowed only in ( receive statement) s of citer definition) s and (request defi inition) Ss. 
that are written to communicate with full duplex terminal types. CONTINUE syntax causes action as 
described below if the co-line executes a ais tinue Statement) before all information specified by the 
(receive statement) is received. ca in ee 


CONTINUE 2 branches control to the next sequential statement. 


CONTINUE:NULL | causes no action. Execution proceeds as if the (continue statement) had 
2 not been executed. — : | | 
CONTINUE: (abel) branches control to.(Iabel).. | 
CONTINUE:ABORT - Not allowed. _ | 
CONTROL es | 


The CONTROL option variations cause the following acNions if the control character of the station (as 
defined in the (station control character statement) i is reveived: oo : = | 


~ CONTROL sets TRUE the bit varia\le) CONTROLFLAG, and d branches control 
| | fo 2 fa; to the next sequential stattment. | 


CONTROL:NULL gets TRUE the (bit variable CONTROLFLAG, and execution continues 

| asf the character was not the station’ s control character. wet, 

CONTROL: (label) “a TRUE the cbt variable) CONTROLFLAG, and branches control to 
| — Clabel). | 


-CONTROL:ABORT —_Not allowed. 


: . ‘ : ed 3 Lek on ti hd? 3 
ne ee eee er: iia 8. OR ie ee lO TR ates ttm erro ian NCES Tits se 
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~ CRCERR 


The following CRCERR option variations cause the following actions if the first character reccived docs 
not equal CRC[O], or the second character received does not equal CRC|1]. (This item is-appropriate 
only for the RECEIVE CRC form of the (rec vive statement); refer to the CRC option.) 


CRCERR sets TRUE the (bit variable) CRCERR, and branches control to the next 
| sequential statement. 


CRCERR:NULL causes no action. Execution proceeds as if the error did not occur. 
CRCERR:(label) —_ sets TRUE the eee wars CRCERR, and branches control to (label). 
CRCERR: ABORT Not allowed. ae 

END a P, tant. fee 


The END option vaiations cause the following actions if the “ond” character of the station (as defined | 
by the (terminal end character statemen oo in the aed definition) associated with the Station) 
is received: | : 


END © : ; - causes ‘control to branch. to the next sequential statement. 
END:NULL causes no action. Execution proceeds as if the character was not the 
~ “ond” character. - . : 
END: label) | branches control to (label’, 
_END:ABORT ~=—_—s Not allowed. | 
FORMATERR 


The following variations of the FORMATERR ation cause. ‘the following actions if the characters received 
are not equal to those in the (string) (this item is apEropnate only for the RECEIVE (string) construct of :, 
the (receive acid | | | | 


FORMATERR Soe es _ ‘sets TRUE the (bit variable ) FORMATERR, and 
ss a 3 i 5, 3 branches control to the next sequential statement. 


FORMATERR:NULL - ae ; causes no action. Execution proceeds as if the 
| | Be | - error did not occur. | 


~ FORMATERR: (label) oe sets TRUE the (bit variable) FORMATERR, and 
BR ae ge 2 2 ob branches control to yen = | 


FORMATERR:ABORT == = —-_._ notallowed. 
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LOSSOFCARRIER 


The LOSSOFCARRIER setionk variations cause the following actions if a loss of Carrier is detected while 
receiving. 


LOSSOFCARRIER sets TRUE the (bit arule LOSSOFCARRIER, and branches 
7 control to the next sequential statement. | 


LOSSOFCARRIER:NULL causes no action. Execution cree? as if the error did not 
| occur. | ble 


LOSSOFCARRIER:</abel) sets TRUE the (bit variable) LOSSOFCARRIER, and branches | 
| - control to (label). | 


LOSSOFCARRIER:ABORT _ sets TRUE the (bit variable LOSSOFCARRIER, and executes — 
| | an implicit TERMINATE ERROR. . 


There is one exception to the actions described above. If a loss of carrier is. detected: while receiving, - 
and if the terminal is modem-connect, and if the terminal’s (station definition) references a (modem — 
defi nition) that contains the statement LOSSOFCARRIER=DISCONNECT, then an implicit dis- _ 
connect is s done, regardless of the action specified. | _ 


PARITY 


The PARITY option variations cause the following a actions if a Panty bit error is detected. by the adapter 
cluster: ) | 


PARITY sets TRUE the (bit ene PARITY, and branches control to the 
oa | . next sequential statement. , 


PARITY:NULL | | ; causes no action. accion proceeds as if the error did not occur. 


PARITY: (label) sets TRUE the (bit variable) PARITY, and branches control to 
* f Cabell). | | | 
PARITY: ABORT ‘sets TRUE the (bit variable) PARITY, and executes a 
, _ | TERMINATE ERROR. | ie. 
STOPBIT | : ae 
i STOPBIT erica vatiatious cause the described eee ifa ee bit error iS detected by the adapter 
cluster: | | 
STOPBIT | sets TRUE the (bit variable , and praniches control to the next 
| sequential statement. _ a 
ST OPBIT:NULL | causes no action. Eescndon proceeds as 3 if the error did not occur, 
STOPBIT: (abel) “sets TRUE the (bit variable) STOPBIT, and branches control to 
(label). 
STOPBIT: ABORT sets TRUE the bit variable) STOPBIT, and executes a 
7 | | TERMINATE ERROR. — 
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TIM EOUT 


The TIMEOUT option variations cause the actions described if the time required to receive a character 
exceeds the (timeout time). The (timeout time) is defined in the <terminal timeout statement) , but 
can be overridden by including the (<timeout time) ) or (NULL) syntax options in the (receive 
statement}. 


TIMEOUT | sets the (bit variable) TIMEOUT, and branches control to the | 
| | next sequen tial statement. 


TIMEOUT:NULL | Causes no action. Execution proceeds as if the error did not occur. 
TIMEOUT:</abel) . ~——_—_sets TRUE the (bit variable) TIMEOUT, and branches control to 
| | (label). 
TIMEOUT: ABORT “sets TRUE the (bit variable) TIMEOUT, and executes a 
TERMINATE ERROR. | 
TRANERR 


The TRANERR option variations cause the described actions if the characters received and the 
Receive Transmission Number stored in the Station Table are not equal (this item is allowed only in 
the RECEIVE TRAN construct of the <receive statem ent)). , 


TRANERR sets TRUE the ¢ bit variable) TRANERR, and branches ent. 
to the next sequential statement. 


TRANERR:NULL causes no action. Execution ere as if the error r did not occur. 


TRANERR: label) sets TRUE the - variable) TRANERR, and branches control to 
(label). 
TRANERR:ABORT not allowed. 
WRU 


The WRU option causes the following actions if the WRU character of the station is received (the 
(station WRU character statement) defines the WRU character): 


WRU scts TRUE the WRU (bit variable), and branches control to the — 


| next sequential statement. | 
WRU:NULL sets TRUE the WRU (bit variable), and execution proceeds as if 
3 | the character received was not the WRU character. | 
WRU: </abel) | io _" the (bit variable) WRU, and branches control to” 
label 


WRU: ABORT a not allowed. | 
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Receive Statement -- Continued _ 


The (single character) syntax causes the following actions if a character TeCelVeN is equitl to the (single 


character) : 
(single character) branes control to the next sequential statement. 
<single character) ‘NULL _s causes no action. Execution proceeds as if the character received 


was not equal to the (single character). 


(single character): label) branches control to label), 


<single character):ABORT _ not allowed. 


The allowable combinations of the (receive statement) syntax options are defined in table 5-2. The (NULL} 
and ( (timeout. time) ) options are allowed in any form of the (receive statement) . Allowed combinations 
of the other syntax options are denoted by a “*X”’ in the appropriate columns and rows. 


Supplementary Examples 
Statement 


RECEIVE (3 SEC) [TIMEOUT: 10]. 


RECEIVE ADDRESS [ADDERR:99]. 


RECEIVE CHARACTER [CONTINUE: 10, 


CONTROL: 20, 
TIMEOUT: 30, 
eon °:40). 


Explanation 


Causes the adapter cluster to attempt to receive a 
character. If the character is not received within 
3 seconds, the (bit variable) TIMEOUT is set 
TRUE and control branches to 10. 


If the character(s) reccived do not equal those 
defined in the (station address statement), the 
(hit variable) ADDERR is set TRUE, and control 


branches to 99. 


This statement would Saly be allowed ina 


| (control defi inition) or (request definition) that is 


written to communicate with full duplex terminal 
types because it contains the CONTINUE option. 


CONTINUE: 10 would cause a branch to 10 if the 
co-line (control definition executes a (continue 


statement) before a character i is received. 


CONTROL:20 would set CONTROLFLAG TRUE 
and branch to 20 if the character received i iS the , 


' station’ S control character. 


_ TIMEOUT:30 would set TIMEOUT TRUE and — 


branch to 30 if a character is not received within 


the (timeout time) defined in the (terminal 


timeout statemen t). 


“40 would cause a branch to 40 if the character 


| received is the asterisk character. 
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Receive Statement — Continued 


Statement a Explandtion 


RECEIVE[ERROR[0] ] ; An attempt is made to receive one character and 
store itin CHARACTER. If any errors described 
in the associated error switch statement) occur 
while receiving, then the action defined in that 
<error switch statement) is taken. 


RECEIVE[0] 7 Same as above. . 


Table 5--2. Allowable Combinations for (receive statement) 


BCCERR 
CONTROL 
CRCERR | 
FORMATERR | 
PARITY 

_STOPBIT 

-TRANERR 
(single character) 


| END 
WRU 


| ADDRESS 
ADDRESS(RECEIVE) 
ADDRESS(TRANSMIT) 
BCC. 
CHARACTER 
| CRC 
(string) 
TRAN 


x » » | ADDERR 
> >< ->¢ d¢ >¢ de de o¢ | LOSSOFCARRIER | 


> >¢ > > > oe > | BREAK 
MK OM x x > x | BUFOVEFL 


~ > > > > > > | CONTINUE 
> > >¢ dd dd > >t > | TIMEOUT. 


~ > OM OO 
Md od Dd OO OO 


-Detinitions 
CONTROL — 
Shift Statement 


SHIFT STATEMENT 
Syntax 


_— oo Z 
—2 DOWN ————_—— 4 | 


Semantics 


The (shift statement) is to be used ina (control defi nition) that communicates with stations using the 
Baudot (5-bit) character code set. (The character code set is defined in the Germinal code eae of 
the associated (terminal definition). 


SHIFT UP indicates that received characters are to be translated to ) their respective uppercase graphics 
(usually referred to as FIGS). 


SHIFT DOWN indicates that receive characters are to be translated to their respective lowercase graphics _ 
(usually referred to as LTRS). | 


If the station does not use Baudot code, the (shift statement) acts as a no-op. 
Pragmatics . | 


In the Baudot character code set, most bit patterns have two graphic representations: one is referred to as. 
FIGS (the uppercase graphic), and the other as LTRS (the lowercase graphic). | 


When transmitting to a terminal that uses Baudot code, ‘the terminal prints LTRS until it receives a specially 
designated character indicating that it should shift to printing FIGS. The terminal continues printing the 
FIGS until it receives a specially designated character indicating that it should resume printing the LTRS. 


When the information is received from a terminal that uses. Baudot, the same: conventions hold true; that is, 
the terminal communicates whether FIGS or LTRS follow by the transmission of a designated character. 
The terminal initially transmits LTRS. | | 
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Sum Statement 


SUM STATEMENT ; 
Syntax 
SUM 
& BCC 
= CHARACTER 
= RETRY— 
- T ALLY > [ ——(tally number) ——> ] 
p- (single character) 
Examples 
SUM AL. 
SUM CHARACTER. 
SUM “A”, |. 
SUM TALLY [1]. | : 
Semantics | | | | | | a — 
The purpose of the (sum statement) is to affect the calculation of the horizontal parity check (whether that — | 


be a Block Check Character or a Cyclic Redundancy Check). The specific effect cf the (sum statement) is . 
dependent upon two factors: the SUMmed item, and whether the station’s ¢erminal peuenon) for which 
¢ontrol definition) is running, defines horizontal parity as CRC(16). 


Following is a description of the effect that each form.of the (sum statement) has on the calculation of the 
horizontal parity check. Any reference to CRC means CRC[O] and CRC[1] collectively. 


SUM 
Semantically equivalent to SUM CHARACTER. 
SUM Al 


If the horizontal parity check is a Block Check Character or is undefined, the contents of AI are exclusively 
OR-ed with the contents of BCC, and the result is stored in BCC. | 


If the horizontal parity check is a Cyclic Redundancy Check, the Cyclic Redundancy Check algorithm is 
computed with the contents of AI and CRC, and the result is stored in CRC. 


SUM BCC 


If the horizontal parity check is a Block Check Character or is undefined, then the contents of BCC are 
exclusively OR-ed with itself, and the result is stored in BCC. (The result in BCC would be zero in this 
case.) 


If the horizontal parity check is a Cyclic Redundancy Check, the Cyclic Redundancy Check algorithm i is 
computed with the contents of CRC|O] and CRC, and the result is s stored I in CRC. 
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Sum Statement — Continued 


SUM CHARACTER | 


If the horizontal parity check is a Block Check Character or is undefined, the contents of CHARACTER are 
exclusively OR-ed with the contents of BCC, and the result is stored i in BCC. 3 | 


If the horizontal parity check i is a Cyclic Redundancy Check, the Cyclic Redundancy Check algorithm i is 
computed with the contents of CHARACTER and CRC, and the result is stored i inCRC. — 


SUM RETRY 


If the horizontal parity check is a Block Check Character or is undefined, the contents of RET RY are exclu- 
sively OR-ed with the contents of BCC, and the result stored in BCC. 


If the horizontal parity check is a Cyclic Redundancy Check, the Cyclic Redundancy C mek algorithm i is 
computed with the contents of RETRY and CRC, and the result i is stored in CRC. ) a 


SUM TALLY [(tally number) ] 


If the horizontal parity check is a Block Check Character or is undefined, the contents of TALLY | (tally 
number >| are exclusively OR-ed with the contents of BCC, and the result is stored in BCC. 


if the horizontal parity check is a Cyclic Redundancy Check, the Cyclic Redundancy Check algorithm i is 
computed with the contents of TALLY | (tally number) |. and the on Is stored 1 in CRC. 


SUM {single character) 


If the horizontal parity check is a a Block Check Character or is undefined, the (single character is exclu | 
sively OR-ed with the contents of BCC, and the result is stored in BCC. 7 


If the horizontal parity check is a Cyclic Redundancy Check, the Cyclic Redundancy Check, the Cyclic 
Redundancy Check algorithm is computed with the (single character) and. CRC, and. the: result i 1S. stored} in 
CRC. | | | | 


a 


De finitions 
- CONTROL 


Transmit Statement 


TRANSMIT STATEMENT | 
Syntax ? | | | 4 
TRANSMIT , nis A | | 
i ADDRESS - | Se ee 4 x i > | > BREAK " 
(RECEIVE) | 
Eee os 
BCC es anes 
= CHARACTER 
> CRC——— 
> SEQUENCE. 
> TRAN 
(string) 
Examples 
TRANSMIT, 


TRANSMIT CHARACTER |BREAK:NULL].. | 

TRANSMIT SOH STX 400” [BREAK: 10]. 

TRANSMIT TRAN. —— ee | 

TRANSMIT ADDRESS (TRANSMIT) [BREAK]. 
Semantics | | — | | - a a 
The (transmit statement) causes the adapter cluster to transmit information to a terminal. The following © 
group of syntax options specifies the information to be transmitted. All options except CHARACTER 
use the (byte variable) CHARACTER as a temporary storage area; thus, any information contained in 
CHARACTER before execution of the (transmit statement) shall be destroyed by the (transmit statement). 


If none of the first group of options is chosen, it is semantically equivalent to specifying CHARACTER 
(i.e., “TRANSMIT.” is equivalent to “TRANSMIT CHARACTER.”). _ 


ADDRESS 


The proper number of characters (as specified by the station’s associated (terminal definition) in the | 
terminal address size statement) ) are taken from the address field in the Station Table and transmitted. 


_ADDRESS(RECEIVE) aus a = 

This option is equivalent to ADDRESS, except that ADDRESS (RECEIVE) must be used when an 
address pair is defined in the (station address statement) and the programmer wants to transmit the 
receive address. © 7 es ae | oe | 
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ADDRESS (TRANSMIT) 


This option is equivalent to ADDRESS, except that ADDRESS (TRANSMIT ). must be tised when an 
address pair is defined in the (station address statement) and the Eee wants the transmit address 
transmitted. | 


BCC | . @ & | | | 

The BCC option causes the contents of the (byte variable) ilaas 
CHARACTER | | 

The CHARACTER causes the contents of the ne vie variable) CHARACT ER to be transmitted. 
CRC Sp 


This option causes two bytes to be transmitted; the contents of CRC [0] are transmitted first, followed | 
by CRC [1]. If the station’s associated (¢ terminal defi nition) does not define horizontal parity as 
CRC ({16] ), the use of this option) | causes a syntax. error to be penesatce at compile time. 


SEQUENCE | 


The SEQUENCE option causes the characte representation of the value stored in the Senuiente field | ‘ 
of the Station Table to be transmitted if the station is in sequence mode (i. e., this 8 Sb variable} SEQUENCE _ 
is TRUE); otherwise, the crams statement) is a no-op. : : 


TRAN 


The proper number of transmission aber evaractets (as defined By the station's associated (terminal 
definition) in the (terminal transmission number length statement) ) are extracted from the Transmit 
Transmission Number field in the: Station Table and then transmitted. 3 


(serine 
Fach character of- the (string) is transmitted. 


The BREAK syntax allows the programmer to specify. action if a “break” i is received fon the ‘erminal: 
while the adapter cluster is still transmitting. If this option is omitted and a break occurs, an implicit 
TERMINATE ERROR is executed. The following describes the actions of the three syntactical forms: 


BREAK sets TRUE the (bit variable) BREAK [T RANSMIT, and causes. 
: : a branch of control to the next statement. 
BREAK: abel) ; “sets TRUE the (bit variable) BREAK [TRANSMIT]. and causes 


a branch of control to (label). 


‘BREAK: NULL causes no action. Execution Proceeds as if the break did not occur. . 
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Wait Statement . 
WAIT STATEMENT Se as 
— Syntax 

WAIT 


(——&> (wait time) 


Examples 


WAIT. 
WAIT (3 SEC). 
WAIT (5 MILLI:6). 


Semantics 


The (wait statement» is only allowed in ¢ control definitions that are written to communicate with 

full duplex terminal types. Execution of this statement causes the (control definition) to be suspended 
until the co-line executes a (continue statement). The optional syntax effects the statement as described 
below: : | 7 7 7 | 


(wait time) defines the maximum amount of (time) that the (control 
3 definition) should be suspending waiting for the (continue 
iim If (wait time) is exceeded and the co-line has - 
not executed a (continue statement). execution resumes at 
the next sequential statement. pe 


( wait time): (label) same as above except execution resumes at Gabel) it a 
, — Ccontinue statement) is not executed within Gvait time). 


Pragmatics 


Refer to the C fork statement) pragmatics. 


544 


‘Definitions 
— DCP 


DCP DEFINITION 
Syntax 


DCP-———___>> (DCP number) —> : « DCP exchange statement). | 
> (DCP memory size statement ) 


(DCP terminal statement \ - 


Example 
DCP 1: 
MEMORY = 8196. 
EXCHANGE = 
TERMINAL. = SOMETERMINALNAME. 
Semantics 


The (DCP defi nition is the means s by which the programmer defines attributes of Sach Data Communi- 
cations Processor (DCP) i in the Data Communications System. con fh 4 , . 


The (DCP number) identifies the DCP and must correspond to an address (ranging from 0 through 7). * 
wired into each DCP by the field engineer. The attributes of the DCP are defined subsequently by means <a 
of (DCP statements. A maximum of eight DCP definitions may Appest in the NDL source ig a | 


Each (DCP statement) is described subsequently. © 
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DCP EXCHANGE STATEMENT | 
Syntax | 


EXCHANGE ———» = —————_—» (DCP number) - 


| Example 
EXCHANGE = 4. 
Semantics 


The (DCP aichange statement) specifies that the DCP shares hardware-exchanged a daa clusters with 
another DCP. (DCP number) defines the other DCP. 


This statement is required in any (DCP definition) eierenced by a (pcp exchange statement ) in another | 
(DCP definition), or in any (DCP i that does not have lines defined for it in the (line defi sassaee. 
section of the source program. 2 ae 


Prasmatics 


The maximum number of DCPs that can share a set of adapter clusters i is 2. The definitions of both DCPs | 
that share adapter clusters must contain a (DCP exchange statement) naming the ( DCP number) ofthe 
DCP with which it shares the adapter clusters. For. éxample, if DCP 1 and DCP. 2 share adapter clusters, 
then the definition of DCP | must contain the statement _ 7 | 


EXCHANGE = 2. 


and the definition of DCP 2 must contain the statement | 
EXCHANGE = 1. | | 


If a DCP shares adapter clusters with another DCP, then any adapter cluster connected to either of the 
‘DCPs must be shared by both. A DCP i is not allowed to share only « a portion of its adapter clusters. 


LINE SECTION REQUIREMENTS 


If two DCPs share adapter clusters, it is required that the (line defi nition) sf és each DCP be given madnes | 
(by means of a (line address statement) ) such that both DCPs do not have lines defined on the same | | 
cluster. | 


The following program segment would cause the compiler to generate a syntax error because both DCPs 
have lines defined on auODIELe peter 0. | | 7 
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LINE L100: 


"ADDRESS = 1:0:0. % ADDRESS = al :(ADAPTER CLUSTER) :(LINE). 


LINE L201: 
ADDRESS = e 0: 1. 


DCP 1: a 
MEMORY = 8192. > 
EXCHANGE = 2. 

DCP 2: ere a 
MEMORY = 8192. Le 
EXCHANGE = 1. 

_ MCS RECONFIGURATION © 


The EXCHANGE CLUSTERS (TYPE = 129) D DCWRITE function allows a Message C Contréi Syston to 
transfer control of any or all adapter clusters, that are exchanged by two DCPs, from the DCP that cur- 
rently controls. the designated adapter clusters to the DCP with which it is exchanged. This aspect of the 
reconfiguration feature. may be invoked in order. to provide:an. installation with the ability to effect — 
_“oad-leveling” between two DCPs that share hardware-exchanged adapter clusters or to transfer all of © 
the work load of a DCP’to its partner if the DCP malfunctions. For more information regarding recon- 
_ figuration, refer to the B 6700 B ue DCALGOL Reference Manual, : form no, 5000052. _ , 


Supplementary Example 


The following is a program segment describing the data aeiniiunicition: Seen illustrated i in + figure 5-1. 
This example illustrates how the (line definition) and (DCP definition) sections can be written to | 
is a data communications aes in which two DCPs: share hardware-exchanged adapter clusters. - 
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DCP Exchange Statement — Continued ; 


 % 


% STATION DEFINITION SECTION. 


% 


STATION DEFAULT ALLSTATIONS: a 


STATION STAI: 
‘DEFAULT 
TERMINAL = 

STATION STA2: 


~ DEFAU LT: 
TERMINAL = 


STATION STA3: 
DEFAULT 


TERMINAL = 


STATION STA4: 


DEFAULT 
TERMINAL = 


STATION STAS: 


‘DEFAULT 
TERMINAL = 


STATION STAG: 


DEFAULT 
TERMINAL = 


= ALLSTATIONS. 


TTY. 


= ALLSTATIONS. — 


TTY. 


= ALLSTATIONS. _ 


TTY. | 


TTY. 


TTY. 


TTY. 


% : 
LINE DEFINITION SECTION. 


% 
TRIM RIIT 
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LIN ES FOR DCP 0 LRM IIINIINT IT 3 
LINE L000: | 


LINE L001: 


= ALLSTATION S. 2, 
= ALLSTATIONS. _ 


= ALLSTATIONS. 


0:0:0. | 
(DIRECT). 
po 


0:0:1 . 


1(DIRECT). 


STAZ2. 


— LIN E L020: 


ADDRESS 
ADAPTER | 
STATION 


LINE L021: 


ADDRESS = 
~ ADAPTER = 
a STATION = 
_ LINES FOR DCP 1 
LINE L110: 


ADDRESS 
ADAPTER 
_ STATION 


LINE Litt: 


ADDRESS 
ADAPTER 
STATION 


WoW VDA 


%DCP DEFINITION SECTION. — 
DCP O: 


a MEMORY - 
"EXCHANGE | 


“per 1: 


MEMORY. 
EXCHANGE 


wud 


ms 


=e | ; Definitions 
pep 


DCP Exchange Statement — Continued _ 


0:2:0. 
1(DIRECT). 


STAS. 


0: 2:1. ‘i 
1(DIRECT). 
STA6. = 


IIIT IIA ANITA 


~41:1:0, 


| Aoamecn.” 


STA3. 


1. 


1(DIRECT). 
STA 


in 3 eg 4 
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DCP Exchange Statement — Continued 


7 ADAPTER tt” TELETYPE 
DCPs - CLUSTERS LINES § TERMINAL STATIONs 


“STAI” 


CLUSTER 
| 0 | 


“STA2” 


- “STA3” 


. “STA” 


“STAS5S” 


CLUSTER 
2 


“ST A6” | 


_ Figure 5-1 ; Adapter Clusters Exchange 


5-50 


: Definitions daa 
| | DCP | 
DCP Memory Size Statement 


DCP MEMORY SIZE eee 
Syntax 


MEMOR Y———_- == $$» integer) —_____________-_____» 


Examples no 
MEMORY = 4096. _ 
MEMORY = 0. 

Semantics | 


The (DCP memory size ¢ statement) defines the aimnber of words of. local memory in 1 the DCP being. | 
defined. | ee | , 


A zero value for (integer) indicates that the DCP has no local memory and that all code generated for 
the DCP shall reside in main system memory. A non-zero value for (integer) that is less than the amount | 
of local memory re as determined apy the compuel, results i in a compile-time error. 
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DCP Terminal Statement 
DCP TERMINAL STATEMENT 
Syntax 


TERMINAL —*= (terminal identifier) , 


> (—& MSGSPACE —& = —e (integer) —™) 


Examples 

TERMINAL = TELETYPE. 

TERMINAL = M33, TD806 (MSGSPACE = 5), TELETYPE (MSGSPACE = 2). 
Semantics 


The purpose of the (pep terminal statement) is twofold. Each aspect of this. statement is discussed in. 
the subsequent two paragraphs. : 


The primary purpose of the (DCP terminal statement) is to provide the means of speeivins which 
terminal types in the data communications network that the DCP must be able to control. Only those 
terminal types specified in this statement will have the object code required to control them included 

in the object code generated for the DCP. If this statement is omitted from a DCP definition, the com- 
piler includes the object code required to control all terminal types in the data communications ngEWOr: 


The second purpose of the (DCP terminal statement) is to provide a means of specifying the eae 
number of message spaces allotted for each terminal type controlled by the DCP. : | 


The (terminal identifier) must name a terminal type defined bya ¢ terminal definition) and specifies 
a terminal type for which the DCP must have access to the controlling code. 


The (MSGSPACE = (integer) ) option specifies the number of message spaces initially allotted for the 
terminal type. If this option is omitted, two message spaces are allotted by default. 


Pragmatics 


Note that if any terminal type is not named in the (DCP terminal siatement ys the data communications — 
network may not be reconfigured (by means of a reconfiguration. DCWRITE in an MCS) such that it adds 


that terminal type to those terminal types controlled by the DCP. Refer to the supplementary example 
that follows. | 


Supplementary Example 


The program segment below illustrates the pragmatics. A station wide terminal type is SCREEN DEVICE | 


cannot be added on the spare line L003 of DCP 1, because DCP 1 does not have the code available to 
control SCREENDEVICE. — | oe —_ 


% 


To 


% 


REQUEST READTTY: 


REQUEST WRITETTY: 


BLOCK 
SCREEN 
TURNAROUND 
ICTDELAY 
TRANSMISSION 
DUPLEX 
TIMEOUT 
ADDRESS 
PAGE 

CODE - 
INHIBITSYNC 


_ BUFFER © 


MAXINPUT 
WIDTH 
PARITY 
ADAPTER 
WRU 

END | 
BACKSPACE 
CONTROL 


0. 


, | 
%CONTROL & REQUEST DEFINITION SECTION. 


REQUEST READSCREENDEVICE: 


REQUEST WRITESCREENDEVICE: [ 


%TERMINAL DEFINITION SECTION. 


TERMINAL DEFAULT DEFAULTLIST: 
FALSE. 


FALSE. 


0. 
0. 
3 SEC. 


. 0. 


0. 


—ASC67. - 
. FALSE: | 
~ NULL. | 
— 80. 


72. 


NULL. 


4. 
ENQ 


ETX(DYNAMIC). 
_ -BS(DYNAMIC). 
CONTENTION. | 


: 


Definitions 
DCP 
DCP Terminal Statement - 


The object code generated from these state- 
ments is required to control uy. terminal 


types. 


The object code generated from these state- 
ments is required to control SCREEN DEVICE 
terminal types. - 


Continued 


; 


Definitions 
DCP 


DCP Terminal Statement — Continued 


TERMINAL TTY: 


DEFAULT = DEFAULTLIST. - | 
REQUEST =  WRITETTY:TRANSMIT,READTTY:RECEIVE. 
TERMINAL SCREENDEVICE: | 
DEFAULT = DEFAULTLIST. | 
SCREEN = TRUE. | | | | 
REQUEST = WRITESCREENDEVICE:TRANSMIT,READSCREENDEVICE: 
RECEIVE. | 


These statements specify the (request 
definitions) required to control the . 
defined terminal type. The object code 
generated by the procedures named here 
must be accessible by a DCP that has the 
terminal type attached to any of its lines. 


%STATION DEFINITION SECTION. | 
% | 


STATION DEFAULT ALLSTATIONS: _ 


ENABLEINPUT = TRUE. 
LOGICALACK = _ FALSE. —_ 
MCS = SYSTEM/CANDE. 
CONTROL = QM. 
RETRY = 5. _ | 
MYUSE = OUTPUT,INPUT. 
STATION STAI: 3 | 
DEFAULT =  ALLSTATIONS. 
TERMINAL = TTY. | 
| A (line definition) naming any of these 
STATION STA2: | | stations must be a (line definition) for — 
DEFAULT = ALLSTATIONS. DCP 0. DCP 1 does not have access to 
TERMINAL = TTY. | code required to control terminals 
STATION STA3: associated with these stations. | 
DEFAULT = ALLSTATIONS. | | 
TERMINAL = TTY. = 
STATION STA4: : 
DEFAULT = ALLSTATIONS. | | 
TERMINAL = SCREENDEVICE. , = } 
. A < line definition) naming any of these 
STATION STAS: a stations must be a (line definition) for 
DEFAULT = ALLSTATIONS. _ « DCP 1. DCP 0 does not have access to 
TERMINAL | = SCREENDEVICE. code required to control terminals 
STATION STAG: associated with these stations. 
DEFAULT =  ALLSTATIONS. | | | 
TERMINAL = SCREENDEVICE, 
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% . 


YLINE DEFINITION SECTION. 
TDPRI TWIG 


LINES FOR DCP 0 


Detinitions 
PCP 


DCP Terminal Statement ~ Continued 


LINE LOoO0: 

ADDRESS =  0:0:0. 
ADAPTER | = 1(DIRECT). | 
STATION = STAI. : 

LINE LOO: 

ADDRESS = 0:0:1. } The (line station statement) of any (line 

ADAPTER = — 1(DIRECT). definition) for DCP 0 must name a station f 

STATION = STA2. that has a TTY terminal type associated with \ 

L002: it. DCP 0 does not have access to code 

ieee | required to control SCREENDEVICE ter- 

ADDRESS = 0:0:2. ; minal types. 

ADAPTER | = 1(DIRECT). 

STATION = STA3. — 

LINE L003: % THISIS A SPARE LINE | 
ADDRESS = 0:0:3. 

MAXSTATIONS = 1. | 
COMMIT NINN + LINES FOR DCP 1 %%% MUU UI 
LINE L100: 
ADDRESS = 1:0:0. 
ADAPTER =  1(DIRECT). » 
STATION = STA4. — 

LINE L101: The Cline station statement) of any (line 
ADDRESS. = 1:0:1. definition) for DCP 1 must name a station 
ADAPTER = 1(DIRECT). that has ad SCREENDEVICE terminal type 
STATION = STAS. associated with it. DCP 1 does not have 

| access to code required to control TTY 
LINE L102: | | terminal types. 

ADDRESS =  1:0:2. | 

ADAPTER =  1(DIRECT). 

STATION = STA6. 
% 
%DCP DEFINITION SECTION. 
% 

DCP 0: ~ 
MEMORY = §8192. The effect of this statement is that this DCP 
TERMINAL = TTY. has access to control code for TTY terminal 

DCP 1: types only. 

MEMORY = 8192. The effect of this statement is that this DCP 
TERMINAL = SCREENDEVICE. < has access to control code for SCREEN- 


DEVICE terminal types only. : 
| | —55 
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FILE DEFINITION 
Syntax 


FILE ———————— (ile identifier) ——_—__» : —_—___—_ (file family statement) —-| 


Example 


FILE NETWORK: FAMILY = STATIONIDI, STATION ID2, FILEID1. 
Semantics 


The (file definition) provides the means to define a data communications file and specify the stations 
associated with that file. The ¢ file identifier) is the external name (TITLE) of the file, and has the syntacti- 
cal form of a (system identifier) . - | ; 


A single-station file is a file that has one station associated with it. A single-station tile can, but need not. 
be formally defined in a (file definition) . The reason that a single-station file does not need to be defined 
is that cach station is itself a file. The external name (TITLE) of such a file would be the (station identi- 

fier) of the station. 


A multi-station file is, as the name implies, a file that has more than one station associated with it. Multi-- 
station tiles must be defined in (file definition) s. | | 2 gx *e : 


Pragmatics 


A general discussion of data communication files and their peculiarities can be found in chapter 2 of the 

B 6700 Input/Output Subsystem Information Manual, form no. 5000185, under the heading “DATA 

COMM FILES.” The information contained in that discussion is a prerequisite to understanding the | 
significance of (file definition) s. Chapter 3 of the-same manual contains a table that lists all file attributes - 
and provides an explanation of each attribute. Attributes relative to data communication files are found 

by examining the “KIND” column of the table for the key word “Datacom.” The information found 

in the explanation of each data communications-relative attribute is also a prerequisite. 


A detailed discussion of data communications object job 1/O can be found in appendix B of the B 6700/ 

B 7/00 DCALCOL Reference Manual, form no. 5000052, under the semantics of STATION ASSIGNMENT 
TO FILE (TYPE = 64). The information found there is not considered a prerequisite; however, it does 
contribute toward a deeper understanding of data communications files and data communications object 
job I/O. | . : a. | 
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File Famiiy Statement 


FILE FAMILY STATEMENT 
Syntax 


9 -—— 


(file identifier) —_—— 


F AM ILY ————- = 
(station identi fier ) | 


Example | 
FAMILY = STATIONID1, STATIONID2, FILEID1. 
Semantics 


The (file family statement ) defines the stations associated with a data communications file. Ifa ( file 
identifier) is named, all of the stations associated with the file named will also be associated with the 
file being defined. Any duplication of an (identifier) ina ( file family statement) is ignored. 


Supplementary Example 


The following example is the (file de finition) section of a hypothetical NDL program. Assume that the 
stations STATION! , STATION2, STATION3, STATION4, STATIONS, STATIONS, STATION7, and 
STATIONS have been defined in the (station definition) section. 


FILE TTYS: | | file. The FAMILYSIZE is 3. 
FAMILY = STATION1, STATION2, STATION3. _  STATIONI, STATION2, and 
: STATION3 are the stations 


TTYS is the (identifier) of ac 
associated with this file. 


FILE CRTS: . of 3. The stations associated 
FAMILY = STATION4, STATIONS, STATIONS. __ ) with the file are STATION4, 
| e STATIONS, and STATION6. 


‘EXECUTIVES has a FAMILY- 
| | | SIZE of 5. The stations 
FILE EXECUTIVES: | ‘J associated with the file are 
FAMILY = STATION1, CRTS, STATION6, STATION 7. STATION1, STATION4, 
7 | | | STATIONS, STATION6, and 
\ STATION 7. 


_ ( THE/ENTIRE/NETWORK : 


CRTS also has a FAMILYSIZE | 


a FAMILYSIZE of 8. The 
stations associated with THE/ 
ENTIRE/NETWORK are 

) STATION1,.STATION2, 
STATION3, STATION4, 
STATIONS, STATION6, 
STATION7, and STATIONS 


FILE THE/ENTIRE/NETWO RK: 
FAMILY = STATION’, STATIONS, TTYS, CRTS. 


Definitions 
LINE 


LINE DEFINITION 
Syntax 


LINE (line identifier) “a Y (line wanes class statement 5 
. DEFAULT -» (default line a, nua (line address statement ) 
| = Cline answer wiavenient 
w- (line default statement ) 
> ( line endofnumber statement ) 
—s» (line maxstations statement ) 
p> (line modem statement ) 
ps» (line phone statement \ 
p> (line station statement) 


a (line type statement ) - 


Examples 

LINE TTYDIALIN: 

TYPE = DIALIN. 
ADAPTER = 1(MODEM). 
MODEM | = TTYMODEM. 
ANSWER = TRUE. 
PHONE = 2139686521. 
ADDRESS = 0:0:0. 
STATION = TTYSTATION. 
MAXSTATIONS = 1. 

LINE DEFAULT LINEDEFAULTLISTI1: | 
ADAPTER = 1 (MODEM). — 
ANSWER = TRUE. 
ENDOFNUMBER. = FALSE. 
MAXSTATIONS = |. 

TYPE = DIALIN. 
MODEM = TTYMODEM. 
Semantics 


(line identifier) and (default line identifier) both have the same syntactical form as (identifier) . 


Each form of the (line definition) syntax is described subsequently. 
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Definitions _ 
LINE © 


Continued 


LINE (line identifier) : .. ; 


This form of the Cline definition) defines the attributes of a logical line in the data communications 
network. Line attributes are defined in one of the following ways: 7 | 


Hach attribute is defined explicitly by means of a (/ine statement) in the line definition). 


il. 
b. Each attribute is defined implicitly by an explicit reference to a set of default attribute values. 
C. 


Some of the line attributes are defined implicitly as in b, and the remainder are defined 
explictly as in a. ; : , SS 


Some (line statement)s must be defined for each (Jine definition); others do not. Some of the statements 
may or may not require definition, depending upon the appearance of other statements. The semantics 
portion of each (line statement) states, among other things, whether the attribute must be defined and 

its effect upon the requirements of other attribute definitions. - | | | 


To define the attributes of a line as described in item a above, this syntax form must be used. 


To define the attributes of a line as described in items b and'c above, this syntax form, the following 
syntax form, and the (ine default statement) must be used in conjunction (this is described under the 
following syntax form). | | “a 7 | | 


LINE DEFAULT (default line identifier)». . 


This syntax form is referred to as a Default (line definition) . Its purpose is to decrease the number of 
source statements required to define all of the logical lines in the data communications system. This is 
accomplished in the following. manner. Attributes common to several logical lines are defined by means _ 
head of a Default (line csmiay Associated with each Default ¢ line definition) isa (default line identifier). 
5 ane Subsequent to the Default ¢/ine definition), any (line definition) that has those attributes in common can . — 
reference the (default line identifier) , instead of repeating the list. (A ¢ default line identifier) is 
referenced by means of a (line default statement).) The NDL compiler uses the last definition of a line 
attribute, and therefore the programmer can reference a Default (line definition) and change any — 
attributes by redefining them in the (line definition). = = aa ee 


In appearance, the Default (line definition ) is Similiar to the (line definition). The differences are that 
the reserved word DEFAULT follows the reserved word LINE, and that there are no statements that are - 


required to be defined in a Default (/ine definition). 
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Definitions 
LINE | | 
Line Adapter Class Statement : | _ — 


LINE ADAPTER CLASS STATEMENT 
Syntax 


ADAPTER —— = —— {(integer) value of I thru g} 


Examples 
ADAPTER = 5. 
ADAPTER = 4 (MODEM). 
Semantics | 


The (line adapter class statement) identifies the Adapter Class of the line adapter for the logical line and, 
optionally, names the connection type (i.e., modem connect or direct connect). | 


The Adapter Class must be compatible with the communication type number) specified in the (station 

adapter statement) of any station assigned to the line. (Note that all stations assigned to a line must 

have the same (communication type number) defined.) Table 5-3 lists the compatible Adapter Classes 

for each (communication type number). For example, a line having stations assigned to it that define a 
a communication type number) of 4 can name as an Adapter Class either 1,-2, 3, 4, or 5 (refer to — 
table 5-3). On the other hand, a line having stations assigned to it that defines 15 as the (communication * Nw’ 
type number) can name only 5 as an Adapter Class. | | | oo 


If the connection type is named in the statement, it is considered by the compiler as documentation 

only. The compiler determines whether the line adapter or a modem-connect line adapter, by the presence 
or absence of a Cline modem statement) for the ¢ line definition). A syntax error is generated, however, 

if DIRECT is named and a (line modem statement) is present. | , | 


Pragmatics 
LINE ADAPTERS AND ADAPTER CLASSES 


There are 13 available line adapters. Three of the 13 are special-purpose line adapters; they are used 
for Touch-Tone® telephone input, Audio-Response lines, and Automatic Calling Units (ACU). The 
remaining 10 are general-purpose line adapters. — 


The 13 available line adapters are divided into eight ‘‘Adapter Classes.”” The Touch-T one® , Audio- | 
Response, and ACU line adapters comprise Adapter Classes 6, 7, and 8, respectively. The 10 general- 
purpose line adapters comprise Adapter Classes | through 5. Adapter Classes | through 5 differ primarily 
in the maximum transmission speed at which the line adapters may be operated. Adapter Classes | 
through 5 each consist of two line adapters, one being a “direct connect,” and the other being a “modem | 
connect.” The direct connect has a terminal attached to it by means of a two-wire or four-wire direct 
connection. The modem connect has a terminal attached to it through modems using an RS232+ 

defined interface. Refer to table 5-3 for the Adapter Class and the use of each line adapter. 


TA technical specification published by the Electronic Industries Association establishing the interface 
requirements between modems and terminals or computers. | | : 
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LINE 


Line Adapter Class Statemer +t — Continued 


Table 5-3. Available Line Adapters 


MARKETING 3 
NUMBER* CONNECTION USE | CLASS 


B 6650-1 . Direct Two-wire direct connect, asynchronous > a 
bit-serial transmission up to a maxi- 
mum line speed of 600 BPS, simplex or 
half-duplex. | 


B 6650-1 Modem Modem-connected with 100-Series type 1 
modem using RS232-defined interface, 
asynchronous bit-serial transmission 
up to a maximum line speed of 600 
BPS, simplex. or half-duplex. (Two | 
required for full duplex.) 


B 6650-2 Direct | Same as B 6650-1D, except maximum 
line speed is 1800 BPS. 


B 6650-2 _ Modem Same as B 6650-1M, except with 202- _ 2 | 


ho 


Serics type modem and up to a maxi- 
mum line speed of 1800 BPS. | 


B 6650-3 Direct ' Same as B 6650-1D, except maximum 3 
line speed is 2400 BPS. ey 


“ese” B 6650-3 Modem _ Modem-connected with 202-Series (asyn- _ 3 
- chronous) or 201-Series (synchronous) 
modem using RS232-defined interface, 
bit-serial transmission up to a maxi- 
mum line speed of 2400 BPS, simplex 
or half-duplex. (Two required for 
full duplex.) 


B 6650-4 Direct Same as B 6650-1D, except maximum 4. 
line speed is 4800 BPS. . 

B 6650-4 Modem Same as B 6650-3M, except maximum 4 

: line speed is 4800 BPS. | : 

B 6650-5 Direct Same as B 6650-1D, except maximum 5 
line speed is 9600 BPS. | 

B 6650-5 | Modem Same as B 6650-3M, except maximum 2 25: 
line speed is 9600 BPS. | 

B 6650-6 For Touch-Tone® telephone input. | 66 

B 6650-7 | For Audio-Response line. 

B 6650-8 For Automatic Calling Unit (ACU). 8 


*The above marketing numbers refer to B 6700 line adapters. B 7700 line adapters have similar 

numbers, the difference being a leading 7 instead of a 6; e.g., B 6650-1 for B 6700, and B 7650-1 for 
B 7700. In this table only, a distinction is made between modem-connected line adapters and direct- 
connected line adapters by affixing either a D (for direct-connected) or an M (for modem-connected) 
to the field marketing numbers (under the “Use”? column) which require that distinction. 
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LINE 
Line Address Statement 


LINE ADDRESS STATEMENT 
Syntax 


ADDRESS —-»= —» (DCP number— > : —g- (adapter cluster number) : —>(line adapter number)» . 


Example 
ADDRESS = 2:0:15. 


The above example would appear in the (line definition) of the line at the 15th line adapter position in 
adapter cluster number 0 of DCP number 2. 


Semantics 


The (line address statement) identifies the DCP number, the adapter cluster number, and the line | 
adapter number of the defined logical line. If two DCPs share hardware-exchanged adapter clusters 

(as defined by the (DCP exchange statement) in a (DCP definition), then the (DCP number) defined in — 
this statement is the DCP initially expected to service the adapter cluster of which the line is a part. This 
statement, which is required, must be defined explicitly in each (line definition). 


(CO) 


Definitions tee 
LINE 


Line Answer Statement 


LINE ANSWER STATEMENT 
Syntax 


———o FALSE aE | 
Semantics 


The (line answer statement) defines whether or not (TRUE or FALSE, respectively) the DCP is to 
automatically answer an incoming call. This statement is required if the (line type statement) in the 
line definition) defines the line configuration as DIALIN only, or DIALIN and DIALOUT. 


If ANSWER = FALSE, an incoming call causes the following actions to be taken by the DCP. A SWITCHED 
- STATUS RESULT (CLASS = 7) message is sent to the MCS of the station that is the first entry in the 

Line Table for that line. (Unless an MCS has reconfigured the line so that it changes the first entry, the first 
entry in the Line Table will be the entry for the first station listed in the (line station statement) of 

the (line definition).) The message has a bit set in it that indicates the line is in a “‘ringing” status. 
Presumably, upon notification of a line in a ringing status, the MCS programmer instructs the DCP to 
answer the phone, or it takes appropriate action to clear the line. | | 


If ANSWER = TRUE, an incoming call causes the DCP to take the following actions.A SWITCHED STATUS 
RESULT (CLASS = 7) message is sent to the controlling MCS of the station that is the first entry in the 
Line Table for that line. In this case the message has a bit set indicating that there has been an incoming 
call, and that the DCP is in the process of answering the call. 


An MCS may change the value of ANSWER after DCP initialization, by means of a SET/RESET 
AUTO-ANSWER (TYPE = 102) DCWRITE. | ; | 


Definitions 
LINE 
Line Default Statement 


LINE DEFAULT STATEMENT 
Syntax 


DEFAULT ——> = ele fill line identifie)-_———___________ 


Example 
DEFAULT = DFLTLISTI1. 
Semantics 


The (line default statement) allows the programmer to specify the (default line identifier) of a set of 
default line attributes to be used fora (line definition) whose description is incomplete. It is advantagcous 
to group attributes that several lines have in common under a Default (line definition) and list the remain- 
ing attributes under cach individual (line definition) . The compiler will then refer to the Default | 

line definition) to complete the (line definition). The (line default statement) is not required to appear 
in a (line definition) ; however, a <line definition) must define all required attributes if a (line default — 
statement) does not appear. | | | | | 
The (line default statement) can appear ina (line definition) or a Default (line definition) . Thus, 
(line default statement) s can be “nested” to combine the attributes of one or more Default (Jine 
definitions) s. | : te | an 
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LINE 


Line Endofnumb:r Statement 


LINE ENDOFNUMBER STATEMENT © 
Syntax 


ENDOFNUMBER——— = 


Semantics 


The (Jine endofnumber statement) applies only to (line definition)s that specify the Automatic Calling _ 
Unit (ACU) Adapter Class in its (line adapter class statement) (e.g., ADAPTER = 8). This statement is 
required for those ( line definition) s, and specifies whether or not (TRUE or FALSE, respectively) the 
ACU has an “end of number” option. | | 
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LINE 


Line Maxstations Statement 


ame are 


LINE MAXSTATIONS STATEMENT 
Syntax 


MAXSTATIONS ——— =| ———_____—_» (integer) ———_—____________________ . 


Example 
MAXSTATIONS = 25. 
Semantics 


The ( line maxstations statement) specifies the number of stations that may be assigned to the defined line. 
If this statement does not appear for a line having assigned stations (the ( line station statement) lists all 
stations initially assigned to a line), it is assumed that MAXSTATIONS is the number of stations explicitly 
specified as assigned to the line in the (/ine station statement). The <integer) specified must not equal 0, 
exceed 255, or be less than the number of stations listed in the (line station statement) (if the (line station 
statement) is defined). 7 


Pragmatics 


This statement informs the compiler of the maximum number of station descriptors required in the Line 
Table of the DCP’s table structure. By defining MAXSTATIONS to be greater than the number of stations 
listed in the (ine station statement) ,an MCS may reconfigure more stations onto the line at some point a 
in time after DCP initialization. For information regarding reconfiguration, refer to the B 6700/B 7700 Ses/ 
DCALGOL Reterence Manual, form number 5000052.. | i 
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De finitions | 
LINE | 


Line Modem Statement 


LINE MODEM STATEMENT | | 
Syntax 


MODEM ———————-~- = ee (modem identifier) —-_———_—____________> ; 


Example 
MODEM = BELLIO3A. 


Semantics 


The (line modem statement) specifies the modem type that exists on the system end of the physical line. 


(The (station modem statement) ina (station definition) specifies the modem type connected to the line 
on the terminal cnd.) : 7 | 


Pragmatics 


The compiler references other portions of the program with this statement, checking for consistency. If, 
for example, the (modem definition) of the (modem identifier) specified in this statement lists any 
fcommunication type number) s in its {modem adapter statement) that are not compativle with the 
Adapter Class specified in the (line adapter class statement) of the (line definition >, then a syntax error _ 
is generated. Another situation that causes a syntax error to be generated is if the compiler discovers that 
the modem type specified in this statement is not compatibic, in respect to the (communication type 
number) , with the modem type specified in the (station definition) of a station assigned to the line. 
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Line Phone Statement 


LINE PHONE STATEMENT 
Syntax 


PHONE se Ir ger) 


Example 
PHONE = 12136572385. 
Semantics 


The (line phone Statement) , implemented for documentation purposes only, documents the telephone 
number of a DIALIN type linc. This statement is optional in.a (line definition). : 
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Line Station Statement 


LINE STATION STATEMENT 
Syntax 


STATION ——————-Y-= (station identifier) 


Examples 


STATION = RJEI. 
STATION = DAKOTA/KID, BIDS. 


Semantics 


The (line station statement) is the means by which the NDL programmer associates one or more stations | 
with a line. A station that is associated with a particular line is said to be ‘ ‘assigned” to that line. 


This statement is required in those (line defi inition) s that specify DUPLEX in the ine type statement) . 
In all other variations of Cline type statement) , this statement is optional. 


If more than one station is named, each station must have the same « ommunication type number) 
defined in its respective ann adapter statement) . , 
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Definitions 
LINE 
Type Statement 


LINE TYPE STATEMENT 


Syntax 


TYP 


-t-_ => = 


Examples 


TYPE = DIALIN. 


DIALIN 


TYPE = DIALOUT: ACULINE. 
TYPE = DUPLEX: AUXLINE. | | | 
TYPE = DIALIN, DIALOUT: AUTOCALL, DUPLEX:SUPERVISORY. 


Semantics 


The (line type statement) provides the compiler with specific information concerning special logical line 
configurations. This statement is required for (line definition) s whose line utilize either dial-in, dial-out, 


or full duplex hardware facilities. 


DIALIN 


This form identifies the line as a dial-in line. A line that may be dialed from a rem 


The appropriate ine type statement) for this configuration would be: 


TYPE=DIALIN. 


DIALOUT ——e& : ——» (line identifier) 


DUPLEX ———> . —— (line identifier): a 


Ote site is a dial-in line. 


A logical line defined in this manner must include the (ine answer statement) and the Gine modem 
statement). The (line definition) tor such a line could appear as follows: 


LINE DIALUPLINE: 

TYPE = DIALIN. 

ADDRESS = 0:0:0. 

MODEM = TTYIO3A. 

STATION = DIALUPSTATION. 

ANSWER = TRUE. | 

ADAPTER = I(MODEM). 
DIALOUT 


This form identifies the line as a dial-out line. A dial-out line is defined as a line that can become connected 
to a remote site as a result of a Message Control System issuing a DIALOUT (TYPE = 98) DCWRITE to the 
line (thereby causing an Automatic Calling Unit (ACU) to dial the phone number of the remote site). The 


TYPE=DIALOUT: (line identifier’ syntax of the statement specifies such a configuration.’ The (line 


identifier) names the dine definition) that defines the associated ACU. The following example illustrates 


how the Gine definition, s could appear for a dial-out configuration. 


LINE DIALOUTLINE: 
TYPE 
ADDRESS 
MODEM 
ADAPTER 


hon i ou 


DIALOUT: ACULINE. 
0:0:1. | 

TTY103A. 
1(MODEM). 


Sn call 


Definitions. 
LINE 


Line Type Statement -- Continued 


LINE ACULINE: 
ENDOENUMBER 
ADDRESS 
ADAPTER 


A ra 
():¢ 
8. 


| en 


The Gine definition lor the diaFout line must include a (line modem statement) and cannot include a 
(line station statement). The Cine definition) for the ACU must include a (line endofnumber statement, 
and it must define an address (in the Cine address nO ) that is on the same adapter cluster as the 


associated dia-out line. 
DUPLEX 


This form Henne the line as the primary of a line pair, for purposes of simultaneous transmission and 
receptions. The (line identifier) names the auxiliary line’s (line definition) . The line referenced as the 
auxiliary cannot contain a dine {ype statement) nor a (line station statement) . ae 


The following is an example of how full duplex primary and auxiliary lines could: be defined. 


LINE DUPLEXPRIMARY: 


TYPE = DUPLEX:DUPLEXAUXILIARY. 
ADDRESS = 0:0:5. 

MODEM = SUPERMODEM. 

STATION = MODEL37. 

ADAPTER = 1. 


LINE DUPLEXAUXILIARY: 
ADDRESS = 0:0:6. 
ADAPTER = 1. 


Pragmatics | 
COMBINED CONFIGURATIONS 


A dial-in/dia-out litte is characterized by both the ability to be dialed from a remote site, and the ability 

to become connected to a remote site as a result of a Message Control System issuing a DIALOUT 

(TYPE = 98) DCWRITE. This type of configuration requires the DIALIN and DIALOUT: (line identifier) — 
options to appear in the ine type statement). The following example illustrates how a dial-in and dial-out 
line definition) could appear: 


LINE IOLINE: 


TYPE = DIALIN,DIALOUT:AUTOCALLUNIT. 
ADDRESS = 0:1:0. 
MODEM = TTYIO3A. 
STATION = REMOTETTY. 
ANSWER = TRUE. 
ADAPTER = 1(MODEM). 
LINE AUTOCALLUNIT: | 3 
ENDOFNUMBER = FALSE. 
ADDRESS = 0:1:1. 
ADAPTER = 8. 


3-71 © 


Definitions 
LINE 


Line Type Statement -. Continued 


The full duplex syntax could be combined with the dial-in and dial-out syntax as foilows: 


ee 


LINE lIODUPLEX: 
TYPE 
ADDRESS 
MODEM 
STATION 
ANSWER 
ADAPTER 


LINE AUXLINE: 
ADDRESS 
ADAPTER 


LINE AUTOCALLUNIT: 
ENDOFNUMBER 
ADDRESS 
ADAPTER 


WoW Ww Wom tt 


DIALIN DIALOUT: AUTOCALLUN IT. DUPLEX -AUXLINE. 
0:2:0. | 
SUPERMODEM. 

REMOTEDUPLEXDEVICE. 

TRUE. 

1(MODEM). 


0:2:1. 
1(MODEM). 


Definitions 


MCS 
MCS DEFINITION 
Syntax 
MCS -————> ( MCS identifier ) —<$— > CONTROL ——> = es TRUE TT ‘ 
| | -L_» FALSE 7 
Examples 


MCS SYSTEM/CANDE:CONTROL = FALSE. 
MCS SYSTEM/DIAGNOSTICMCS:CONTROL = TRUE. 


Semantics 


The purpose of the (MCS definition) is twofold: First, the (MCS definition) adds the (MCS identifier) to 
the list (contained in the Network Information File) of valid Message Control System (MCS) programs; and 
second, the (MCS definition) specifics whether or not (CONTROL = TRUE, or CONTROL = FALSE, 
respectively) the named MCS is allowed to execute a limited set of DCWRITE functions that pertorm DCP 
diagnostic functions in addition to the standard DCWRITEs. (MCS identifier) has the syntactic form of a 
(system identifier) . , : es 


Pragmatics 


A list of valid MCSs is maintained in the Network Information File in order to restrict unauthorized 
DCALGOL programs from becoming an MCS. (A DCALGOL program becomes an.MCS when it success-_ 
fully executes an INITIALIZE PRIMARY QUEUE (TYPE = 0) DCWRITE.) The MCS declaration is one 
means of ailding a name of an MCS to that list. (One other means is the (station MCS statement) in 

a (station definition) .) | | | 


The diagnostic DCWRITE functions allow an MCS to perform on-line tests of components in the Data 
Communications System. Those DCWRITEs that may be utilized in an MCS when CONTROL = TRUE 
have DCWRITE TYPE numbers greater than 159. : . , 


Definitions 
MODEM 


MODEM DEFINITION 
Syntax 


MODEM —————> ( modem identifier ) ——>: Le (modem adapter statement > 


= (modem lossofcarrier statement \ 


p- (modem noisedelay statement 


Ls {modem transmitdelay statement’ 


Example 
MODEM MABELLI103A: 
ADAPTER = 4. 


LOSSOFCARRIER = DISCONNECT. 
NOISEDELAY = 0. 
TRANSMITDELAY = 0. 


Semantics 


The (modem definition) defines the attributes of a modem type in the data communications system. 
The @nodem identifier) names the (modem definition) , and has the syntactic form of (identifier). The 
vnodem State men are described subsequently. , 
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MODEM 
Modem Adapter Statement 


MODEM ADAPTER STATEMENT _— . 


Syntax 
ADAPTER —: CcOmmunic ation pe number > 
(communication tripe number) 5 eC comununication type number j—> )- 

Examples 

ADAPTER = 1,2,3,4. 

ADAPTER = 10. 

ADAPTER = (2,3), (4,5), 6,7. 
Semantics 


The — adapter statement) defines one or more combinations of character format, synchronous/ © 
asynchronous communication, and line speed (in the case of asynchronous communications) with which the 
modem is compatible. This is done by supplying one or more communication type number) s (or number 
pairs). : | 


Table 5-4 lists the allowed (communication type number)s and the characteristics associated with each. 
For example, the statement — | | a 


ADAPTER = 4. 
defines an [l-bit character format, asynchronous communication, at a‘line speed of 110 bits per second. 


If the modem is to be used in a full duplex mode, and the primary and auxiliary lines have different 
characteristics, then one or more (communication type number) pairs must be supplied. For example, the 
statement | , | | : - | 


ADAPTER = (11,6). 


defines for the primary line a 10-bit character format, synchronous communication, at a speed of 1800 bits 
per second. The characteristics associated with the auxiliary line are the same as for the primary line, 
except that the auxiliary line runs at a line speed of 150 bits per second. | ee 


Pragmatics | 
COMMUNICATION TYPE NUMBERS 


A (communication type number) is an integer that has associated with it a set of attributes that define 
three line characteristics. Those characteristics are the format of the characters transmitted (start informa- © 


tion, data information, parity information, and stop information), whether the line is to be driven 
synchronously or asynchronously, and the speed of the transmissions (in the case of asynchronous 
communications). Table 5-4 lists the allowed (communication type number)s and the line characteristics 
associated with each. : | fei | » 8 


Most of the electronics that directly control a line are located in the adapter cluster that contains the line 
adapter for that line (rather than being located in the line adapter itself). The adapter cluster is somewhat 
general purpose in its design in that it can run at various line speeds and handle various character formats. 
The DCP can cause the adapter cluster to function in a suitably special-purpose way (with respect to a 
single line) by supplying it a number derived from the (communication type number): | ae 


Definitions 
Modem Adapter Statement — Continued - ae a * 5 oe | 


There are three areas in an NDL program that require the programmer to supply one or more (communica- - 
tion type number)s: | | ae = 


a. In the G@nodem adapter statement) of each (modem definition) ; 
b. Inthe Germinal adapter statement) for each ¢erminal definition) , and 


c. Inthe (tation adapter statement) for each (station definition). | | 
As it encounters each area, the NDL compiler cross-checks to determine if the areas are compatible in their 
description. If inconsistencies in component compatibility arise, syntax errors are generated, Restrictions 
are described in the Germinal adapter statement) and (station adapter statement) semantics. 


EXPLANATION OF TABLE 5-4 


Table 5-4 lists the allowed communication type number)s in the column labeled “COMM. TYPE NUM.” 


To the right of each (communication type number) are the three line characteristics associated with it, 
under the columns labeled ‘SPEED (BPS),” “CHARACTER FORMAT,” and “SYNCHRONOUS OR 
ASYNCHRONOUS.” The rightmost column, labeled “COMPATIBLE ADAPTER CLASSES,’ is. | 


referenced and described in the (line definition) section of this chapter. — 
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MODEM _ | | 
~» Modem Adapter Statement -- Continued 


Table 5-4. Table of <communication: type numbers 


egcrleaeaetadasn a, 


meee 


CHARACTER FORMAT 


CHAR. 4 SYNCHRONOUS | COMPATIBLE | 
SPEED | SIZE | START| DATA | PARITY | stop | OR ADAPTER CLASSES 
INFO. 


(BPS) | (BITS) | INFO. | INFO. INFO. | ASYNCHRONOUS | 1 2 3 4.5 678 


45.5 75 1 5.0 ee XXXXxX 

2 56.9 75 1 5.0 — XxXXXX~ 
3 75.0} 7.5 1 5.0 oo oe XX XXX 

4 110.0:| 11.0 1 7.0 1 XXXxXx 

5 134.5 9.0 1 6.0 1 XX XXX 

6 150.0 | 10.0 1 7.0 | |XX XXX 

‘i 300.0 | 10.0 1 7.0 1 XXX XxX 

8 600.0 | 10.0 1 7.0 1 XXXXX 

9 1200.0 | 10.0 1 7.0 1 XX XX 

10 1200.0 | 6.0 l 40.7 f° - es XXXX- 
11 1800.0 | 10.0 1 70 1 a ee « 

12 2400.0 | 10.0 1 7.0 1 XXX. 
13 3600.0 | 10.0 1 7.0 1 X X 

14 4800.0 | 10:0 1 7.0 1 ae 
15 9600.0 | 10.0. 1 7.0 1 xX 
16 2000.0 7.0 6.0 | XX X 

17 2000.0 8.0 7.0 © 1 X X X 

18 2000.0 9.0 8.0 1 XX X 

19 2400.0 7.0 6.0 1 X X X 
20 2400.0 8.0 7.0 1 X X X 
21 2400.0 9.0 8.0 1 XX X 
22 4800.0 7.0 6.0 1 X X 
23 4800.0 8.0 7.0 1 X X 
24 4800.0 9.0 8.0 1 X X 
25 9600.0 7.0 6.0 1 "XxX 
26 9600.0 8.0 7.0 i x 
27 9600.0 9.0 8.0 1. x 
28 40.0 4.0 WO ab we xX 
29 16.0 8.0 “70 | 4 xX 
30. 40.0 | 4.0 
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Definitions 
MODEM 


Modem Lossofcarrier Statement 


MODEM LOSSOFCARRIER STATEMENT 
Syntax 


LOSSOFCARRIER ———» = ———— DISCONNECT 


Pragmatics 


Certain modems (Western Electric (Bell System) 103 serics modems, and possibly others) maintain con- 
tinuous carrier in both directions while the line is properly connected. As such, CF (Carrier Detected) 
und CB (Clear to Send) are maintained TRUE while connected. Additionally, if each modem is equipped 
with both the Initiate Disconnect and the Respond to Disconnect options, each modem employs the 
‘long space disconnect”’ convention. This convention allows one modem to determine if the other is 
disconnecting, and itsclf go “on- hook” and drop C C (Data Set Ready). | 


Two problems arise, however when only one such modem is configured at the system end, and the 
terminal is interfaced with an acoustic coupler at the terminal end. At the time of making a connection, 
establishment of carrier is difficult. In fact, the system modem may detect carrier from the coupler while 
the telephone recciver is near the coupler and before the receiver is properly seated. In this case, CF and 
CB are raised prematurely, and if the system takes this as a cue to begin transmission of a greeting, the 
two signals (the data transmitted from the system, and carrier from the acoustic coupler) interact with 
each other, and the system modem detects loss of carrier. At the time of terminating a call, if the terminal 
initiates the disconnect and has no “‘long space disconnect” facility, or if the terminal operator does not 
use it, the system modem detects only loss of carrier. In this case, the system modem drops CF and CB, 
the modem remains “‘off-hook” and maintains CC (Data Set Ready). Thereaf ter, any incoming sa 
would receive a “busy” signal. | | 


The (modem lossofcarrier statement) is implemented for such a sGnhenration: If this statement is 
included in the definition of a modem, special logic is invoked, in addition to the normal logic, when 
dealing with that modem type. 


In the case of the system calling out, normal logic waits for CC to be raised by the medenit If cc is raised - 


within 25 seconds, the line is immediately rcleased as connected. A timeout of 25 seconds causes CD 
(Data Terminal Ready) to be dropped, the modem goes “ton-hook,” and the line reverts to a disconnected 
state. The special logic is invoked after CC is found TRUE. With the 25-second timeout in effect, the 
special logic then waits until CF and CB are both raised by the modem. After CF and CB are detected, 
the logic then delays approximately 5 seconds before notifying the system that the line is connected. 

This gives the terminal operator sufficient time to place the receiver in the acoustic coupler. 


In the case of a terminal-initiated disconnect, that condition is detected in the normal logic by either the 
“long space disconnect”’ adapter cluster interrupt or by a CC (Data Set Ready) FALSE condition. In 
addition to the normal logic, the ey logic also interprets CF Cope or CB FALSE as a terminal- 
initiated disconnect. 
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MODEM 


Modem Noise: !ay Statement 


MODEM NOISEDELAY STATEMENT 
Syntax 


NOISEDELAY ———-——-» = —————_» ¢ delay time) ne nntnnenteneannenenanearnseanenseenaeeneneeeencammaneacinasfiien ¢ 


Examples 
NOISEDELAY = 0. 
NOISEDELAY = 200 MILLI. 
Semantics 


The (modem noisedelay statement) defines the amount of time that should be delayed when the modem 
enters a Clear to Send (CB) status to avoid receiving “noise” on the line. (delay timeS must be expressed - 
as (time) , and affects the amount of time delayed after an INITIATE RECEIVE or INITIATE TRANSMIT 
construct is executed and before the next statement is executed ina ¢control definition) or (request 
definition) . The (delay time) defined in this statement is used in a compiler algorithm that calculates the 
delay. The compiler algorithm is discussed in the semantics of the INITIATE RECEIVE and INITIATE 
TRANSMIT constructs under the ( initiate statement). This statement must appear in each (modem 
definition). | 
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MODEM 


Modem Transmitdelay Statement 


MODEM TRANSMITDELAY STATEMENT 


Syntax 
TRANSMITDELAY —_—— = ¢ delay time ‘ —-—_---—__—_ "> - 
Examples 
TRANSMITDELAY = 0. | 
TRANSMITDELAY = 150 MICRO. 
Semantics 


The (modem transmitdelay statement) defines the amount of time required for the modem to switch to 

4 Clear to Send (CB) state after receiving a Request to Send (CA). ¢ delay time ) must be expressed as 
(rime) and affects the amount of time delayed after an INITIATE RECEIVE or INITIATE TRANSMIT 
construct is executed and before the next statement is executed in a (control definition ) or (request 
definition). The @elay time ) defined in this statement is used ina compiler algorithm that calculates the 
delay. The compiler algorithm is discussed in the semantics of the INITIATE RECEIVE and INITIATE 
TRANSMIT constructs of the (initiate statement). This statement must appear in cach (modem definition). 


Definitions. 
REQUEST 
REQUEST DEFINITION 
Syntax 


a 


REQUEST we (request identifier) —w.: ee (error switch statement ) 


—-—& (assignment statement) 
7 (label) — : thes > (backspace statement ) 
= (break statement ) , 
> (code statement ) 
= (compound statement) 
= (coniinue statement \ 
e (delay statement ). 
x (fetch statement ) : 
em (finish statement) 
a» ( fork statement 
> ( o tspace stétement ) 
| ~ (go to statement \ — 
» Cif sae’ 
> (increment statement ) 
> (initialize statement) | 
> (initiate statement) 
(pause statement \ 
> (receive shcidonaint’ — 
(shift statement \ 7 
= (store statement \ - 
«sum statement) 
> ( terminate statement ) 7 
( transmit statement ) 


> (wait statement) ——_—m 
—_ | 5—8] 
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Definitions 
REQUEST 


Continued 


Example 
REQUEST READTTY: 


INITIATE RECEIVE. 
RECEIVE TEXT [END]. 
TERMINATE NORMAL, | 


Semantics 


(request definition) s, sometimes referred to as Requests, are coded line disciplines (protocols) that are 
used in communicating with the various terminal types in the data communications network. A (request 
definition) must be coded for each capability of a terminal type; if it is possible for a terminal type to 
send input to the system and receive output from the system, then two (request definition) s must be 
specified for that terminal type in its (terminal definition). The input (request definition ) is generally 
referred to as the “‘Receive Request,” and the output (request definition) the ““Transmit Request.’ (The 
specific (request definition) to be used for each of these capabilities is specified by the (terminal 

request statement). | 


When there is a message to be sent to a particular station on a line, the (control definition) initiates 

the Transmit Request specificd for the (terminal definition) associated with the station. The Transmit 
Request procedure handles the transmission of the message. If the transmission of the message is successful, 
the Transmit Request is terminated, and a branch of control is made back to the (control definition) for 
the initiation of the next Request. 


If the terminal associated with a station is allowed to input data, the (control definition) designated for | 
that line normally initiates the Receive Request specified for the terminal type. lf the terminal has 
information to transmit, the Receive Request procedure obtains a message space in which to store the 
received text, receives and stores the text, and then terminates in a manner that forwards the message to 
the MCS. If the terminal has nothing to transmit, the Receive Request procedure usually notes that there 
was no input, and terminates. In either case, upon termination, control returns to the (control definition) 
for the initiation of the next Request. 


(request identifier) has the syntactic form of (identifier). 


Statements in (request definition) s are executed sequentially. In some cases, however, it is desirable 

to alter the order of execution of statements within the procedure. A (request statement) preceded by a 
label) is one means of accomplishing this. The <g0 to statement) is used to transfer control to a 
label)ed (request statement). . 


A <request statement) must be appropriate for the type of Request in which it appears. That is, some 
(request statement) s are allowed only in Receive Requests, some are allowed only in Transmit Requests, 
and some are allowed in either type. Subsequently, the semantics portion of each statement defines, 
among other things, in which type of (request definition) the statement can appear. ' 
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Assignment Statement 


ASSIGNMENT STATEMENT 
Syntax 
HORM |. LOGICAL ASSIGNMENT 


(assignable bit variable) ———» = >< bit variable) 


TRUE 
FALSE - 
FORM 2 — VALUE ASSIGNMENT 


(assignable byte variable) = (byte variable) 


( integer \————e| + + — { byte variable \. 

- (single character > —- ( integer ) 

_ ( single character ) 

C translatetable identifier )— (—e< byte variable )—» )—* ij 
{receive “address” statement} = 


Examples 


TOG [0] = TRUE. 

TOG |1] = TOG [9]. 

LINE (BUSY) = FALSE. 

RETRY = STATION (TALLY). 

TALLY [0] = STATION (FREQUENCY) — TALLY i]. 

CHARACTER = TRANSTABLEID (CHARACTER). 

STATION (TALLY) = RECEIVE ADDRESS (TRANSMIT) [ADDERR: 999]. 


Semantics 
FORM | 


This form causes the value on the ment side of the equal sign to replace the current value of (assignable 
bit variable). | 


FORM 2 


Value assignment causes a calculated value on the right of the equal sign to be sioied in the (assignable 
byte variable). Arithmetic calculations are done in modulo 255 arithmetic. 


(assignable byte variable) = translatetable identifier) (( byte variable). 


This construct is the means to invoke user-defined character translation. User-defined translation is 
effected by three areas of the NDL source program. 


a. Ina (translatetable definition), the programmer must define the contents of a translation 
table and associate a (translatetable identifier ) with it. 
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Assignment Statement — Continued 


b. Inthe Crerminal definition) of a terminal type that requires special character translation, 
the programmer should suppress automatic character translation by using either of the 
following forms of the (terminal code statement): | 


CODE = BINARY. 


OT 


CODE = EBCDIC. 


ce Ina (control definition) or Crequest definition) , the programmer invokes the translation 
by using this option of the value assignment. Any <b yte variable) can be designated as con- - 
taining the character to be translated. | 


The Cranslatetable identifier) identifies the translation table to be used. An (assignable byte 
variable) is designated to the left of the equal sign, identifying where the resulting translated 
character is to be stored. | 


IfN is the (source size) (defined in the Ctranslatetable definition) ), then the N low-order bits 
of the (byte variable) are used as an index into the translation table. The eight-bit character 
thus indexed is stored in the (assignable byte variable). 


(assignable byte variable) = | receive “address” statement}. 


This construct attempts to RECEIVE the address characters of a terminal, and store in (assignable byte 
variable) the station index of a station whose address characters are equal to those received. The {receive 
“address” statement} is the same as described in the semantics of the RECEIVE ADDRESS construct. 
of the Creceive statement’ The optional syntax in the | receive “address” statement} invokes the samc 
actions as described in the (receive statement) semantics except for ADDERR. Any action specified for 
ADDERR is taken if no valid station assigned to the line is found with address characters equal to those 
received, | : 
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Backspace Statement 


BACKSPACE STATEMENT 
Syntax 


BACKSPACE ——————_—_________________ "= 


Semantics 


The (backspace statement) causes the message text pointer to be moved backwards one character. This 
statement can only appear in a Receive Request. The ‘backspace statement) may be executed repeatedly; 
however, the message text pointer will never be stepped back so far that it points into the message header. 


Definitions 
REQUEST 


Break Statement 


BREAK STATEMENT 
Syntax 


iad Pe se C= . 
( break time’ 7 | delay Hilo | 


Examples 


BREAK (*,NULL). 
BREAK (200 MILLI, 3 SEC). 
BREAK (*, 3 SEC). 

BREAK (100 MILLI, NULL). 


Semantics 


The (break statement) causes binary zeroes to be transmitted on the line, thus changing the state of the 
line to a “spacing’’ condition for a specified time. 


The (break time) specifies the (time) to break. An asterisk indicates that a standard break of 2 character 
times should be used. 


The (delay Wine specifies the (time) to delay subsequent to the break and prior to when control SN 
continues. | | | ass 
é 7 x a 
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CODE STATEMENT 


Syntax 
BINARY 
Semantics 


CODE=ASCII invokes the ASCII-to-EBCDIC translation for received data and the EBCDIC-+to-ASCI 
translation for transmitted data. 


CODE=BINARY inhibits any character translation on data transmitted or apecuived: 
Pragmatics 


The <code statement) allows a programmer to either invoke or inhibit ona logical line the DCP ASCH- 
to-EBCDIC character code translation for input, and the EBCDIC-to-ASCII character code translation 
for output. Any (terminal definition) that names, in its (terminal control statement), a (control 
definition) that utilizes the «code statement) , must define ASCII (BINARY) as its character code in 
the <terminal code statement). (Refer to the (terminal code statement) in this chapter. ) 


Once that translation has been invoked on a line, the translation continues until such time that it is — 
inhibited. If translation is inhibited, translation will be inhibited on that line until invoked again by any 
of the following constructs: CODE=ASCII, TERMINATE NORMAL, TERMINATE LOGICALACK, 
TERMINATE LOGICALACK(RETURN), TERMINATE ERROR, TERMINATE ENABLEINPUT, or 
(while executing a Receive Request) TERMINATE NOINPUT. 
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Compound Statement | — 


COMPOUND STATEMENT 


Syntax 


BEGIN bn srsiaemony 1, END 


a © | 


Example 


BEGIN 
INITIATE TRANSMIT. 
TRANSMIT TEXT. 
FINISH TRANSMIT. 
END. 


Semantics 


The (compound statement) yroups several statements together to form a logical sequence. To execute 
more than one statement when the condition of an (if statement) is satisfied, a (compound statement) 
must be used. 7 7 7 ; 
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CONTINUE STATEMENT 
Syntax 


CONTINUE 


Semantics 


The (continue statement) can appear in only those (request definition) s and (control definition) s 
written to communicate with full duplex terminal types. This statement causes the co-line to resume 
processing, if, and only if, it had been suspended by a (wait statement), or a (receive statement) witha 
CONTINUE option specified. If the co-line had not been suspended, this statement acts asano-op. The 
(continue statement) has no effect upon the line on which it was executed. | ote sb. 2 


Pragmatics 


Refer to the (fork statement) pragmatics. 


Definitions 
REQUEST 
Delay Statement 


DELAY STATEMENT 
Syntax 


DELAY 


= $$ (delay time) —_——_—_» ) —_——___—_». 


Examples 


DELAY (3 SEC). 
DELAY (0). 


Semanitics 


The (delay statement) provides a means to delay a specified period of time before control proceeds to the 
next statement. The (request definition) is suspended in a “‘sleep”’ state for the (delay time) specified. 


Pragmatics 


The “sleep” state induced by tiie (delay statement) allows the DCP to service other logical lines. 
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Error Switch Statement 


ERROR SWITCH STATEMENT 
Syntax 


ERROR —&> [—® ¢ switch number \—= |] —> = label » 


Examples | | 
ERROR [0| = BREAK: 0, BUFOVFL: NULL, LOSSOFCARRIER: ABORT, PARITY: 999, 
STOPBIT: 999. TIMEOUT: NULL. : | 
ERROR [1] = BREAK: NULL. 


‘ERROR |99| = BUFOVFL: NULL. 
Semantics | 
Tite Cerror switch statement) is a non-executable statement that allows the programmer tu define a set of | 
default actions that are to be taken in a Creceive statement) if the specificd errors occur. (switch number 
has the syntactic form of (integer). The semantics of each option is described: subsequently. -7 = 
BREAK 


The BREAK option variations cause the following actions if a break, that is, at least two character-times of 
a spacing line condition, is detected by the adapter cluster while receiving: | 


BREAK: NULL causes no action. Execution proceeds as if the break did not occur. - 


BREAK: (/abel’) sets TRUE the (bit variabl’) BREAK [RECEIVE], and branches | 
control to (label). _ oe 
BREAK: ABORT —___ sets TRUE the (bit variable) BREAK [RECEIVE], and executes an 


| _ implicit TERMINATE ERROR. 
BUFOVFL | | 
The BUFOVFL option variations cause the following actions if the DCP is unable to service a Cluster 


Attention Needed (CAN) interrupt before the adapter cluster receives another character (thus destroying 
the previous character): | | | 


BUFOVFL: NULL causes no action. Execution proceeds as if the error conditions did not 
| occur. | . - 9 ae | —— 
BUFOVEL: (label) sets TRUE the (bit variable) BUFOVFL, and branches control to 


| ‘ label). 


5-91 


Definitions 
REQUEST 


_Error Switch Statement — Continued 


BUFOVFL: ABORT sets TRUE the (bit variable) BUFOVEL, and executes an implicit — 
| TERMINATE ERROR. 7 _ - -e 
LOSSOFCARRIER 


The LOSSOFCARRIER option variations cause the following actions if a loss of carrier is detected while 
receiving. | 3 | 


| | . : 
LOSSOFCARRIER: NULL causes no action. Execution proceeds as if the error did not occur. 


LOSSOFCARRIER: (label) sets TRUE the (bit variable) LOSSOFCARRIER, and branches - 
control to (label ) . | | - 


LOSSOFCARRIER: ABORT. sets TRUE the (bit variable) LOSSOFCARRIER, and executes an 
implicit TERMINATE ERROR. | | 
There is one exception to the actions described in the above. Ifa loss of carrier is detected while receiving, 
and if the terminal is modem-connect, and if the terminal’s (station definition) references a (modem 


definition) that contains the statement LOSSOFCARRIER=DISCONNECT, then an implicit disconnect is 
done, regardless of the action associated with LOSSOFCARRIER in the <error action statement) . 


PARITY 


The PARITY option variations cause the following actions if a parity bit error is detected by the adapter 


cluster: | 7 | 
PARITY: NULL | causes no action. Execution proceeds as if the error did not occur. 
PARITY: (label) _ sets TRUE the «bit variable) PARITY, and branches control to. 
(label) ; | | — ~~ 
PARITY: ABORT sets TRUE the (bit variable) PARITY, and executes a TERMINATE 
_ ERROR. 3 | | | 
STOPBIT 


The STOPBIT option variations cause the following actions if a stop bit error is detected by the adapter 
cluster: | a. 


STOPBIT: NULL | causes no action. Execution proceeds as if the error did not occur. 
STOPBIT: (label) sets TRUE the <bit variable) STOPBIT, and branches control to 
| (label). ae : | | 
STOPBIT: ABORT —___ sets TRUE the (bit variable) STOPBIT, and executes a TERMINATE 
ERROR. a | a | 7 
‘TIMEOUT oo ae: 


The TIMEOUT option variations of the TIMEOUT syntax shown below cause the actions described if the 
time required to receive a character excceds the (timeout time ) . The (timeout time) is defined in the _ 
(terminal timeout statement ) , but can be overridden by including the (.<timeout time) ).or (NULL) - 
syntax options in the (receive statement) . | | , a | 


— TIMEOUT: NULL causes no action. Execution proceeds as if the error did not occur. 
TIMEOUT: (/abel) sets — the <bit variable) TIMEOUT, and branches control to 
(label) . mg | : 


‘Definitions 
REQUEST | 
‘Error Switch Statement — Continued 


TIMEOUT: ABORT sets TRUE the (bit variable) TIMEOUT, and executes a TERMINATE. 
| ERROR. Cae « £% | _ | 


Pragmatics 


An <error switch statement) must be associated with a (receive statement) by means of a (switch number) 
reference before any of the default actions are invoked. The error switch statement) can appear ina | 
< request definition) as.many times as the programmer deems convenient, providing the followii.g restric- 
tion is adhered to: within a given (request definition), <error switch statement )s must have a uniqu. 
(switch number) , and all <error switch statement) s must precede all executable statements, in the 
procedure. | | | | 7 
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FETCH STATEMENT 
Syntax 
FETCH 


EN DOFBUFFER —> : 
7 Examples 


FETCH. 
FETCH [10]. 
| FETCH JENDOFBUFFER: NULL]. 


Semantics 


The execution of the ( fetch statement) loads into CHARACTER, the character pointed to by the message 
text pointer and updates the pointer to point forward one character position. 


When using the (fetch statement), provision should be made for taking action if the sndoethetest buffer 
is encountered. The programmer can specify this action by including the optional syntax shown i in the 
syntax diagram. 


NULL specifies that no action should be taken. 3 | | a | anes 


(label) specifies that control should branch to (label) if the end of buffer is encountered. 


If the end of buffer is encountered and. no action is specified, an implicit TERMINATE ERROR i is 
executed. 


For program documentation, the ENDOF BUFFER syntax can be added to the error action 
specification. 


Supplementary Example 


INITIATE TRANSMIT. 

3: FETCH [ENDOFBUFFER:5]}. 
TRANSMIT CHAR. 
GO TO 3. 

5: FINISH TRANSMIT. 
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FINISH STATEMENT 
Syntax | 
FINISH ——* TRANSMIT 


} oo a SNe 
= = ( delay time \ ———— 
Examples 


FINISH TRANSMIT. | EGE 

FINISH TRANSMIT (NULL). | eae ne si es 
FINISH TRANSMIT (3 SEC). 

Semantics _ 


The purpose of the (finish statement) is to take a line out of the ‘eausiiit oe state “and prepare e the line | 
to receive information. The adapter cluster delays a period of time long enough for the last character 
TRANSMITted to be transmitted, plus 2 milliseconds, before the line is put in a receive ready state. Al- 
though the (finish statement) puts the line in a receive ready state, the cluster hardware invokes a delay 
that inhibits any data from being received for 25 milliseconds. An INITIATE RECEIVE construct should 
precede any subsequent (receive statement) tc to override the 25-millisecond hardware delay. 


The (delay time) option allows the programmer to specify a software delay of (time) before execution 
proceeds in the (control defi inition). | i a | | 


For example, the statement © 
~ FINISH TRANSMIT @ SEC) 
is equivalent to 


FINISH TRANSMIT. 
DELAY (3 SEC). 


The FINISH TRANSMIT (NULL) form is equivalent to FINISH TRANSMIT. 
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FORK STATEMENT 
Syntax. 


FORK eo ( label > 


Example 
_ FORK 10. 
Semantics 


The (fork statement) is allowed in only those (control definition) s and (request definition) s ; 
that are written to communicate with full duplex terminal types. This statement can be executed in the 
ontral definition) or (request definition) of the auxiliary line or the primary linc. The execution of 
this statement causes the co-line control, if not busy, to branch to and begin executing code in the (request — 
definition) that executes the FORK at the (label) specified, while. control on the FORKing line executes 
an implicit PAUSE (i.c.. a (pause statement )) and continues executing in parallel. The co-line is deter- 


mined busy or not busy by testing the BUSY bit (ie.. LINE(BUSY) or AUX(LINE(BUSY)), whichever is _ 
appropriate). If the co-line is busy, the Cfork statement) acts as 4 no-Op. | : | 


Pragmatics 


Synchronization problems can occur between the primary and auxiliary lines as a result of the C fork | 
statement) executing the implicit PAUSE. The implicit PAUSE yields use of the DCP, to allow processing to 
to: proceed on other lines. Thus. processing on the co-line is actually started before the FORKing line o 
exits the ¢ fork statement). Asa result, the programmer must, by some means (e.g., by setting and testing 
line TOGs). effect the synchronization of the lines. This is especially critical if the code contains (wait 
statements and (continue statement)s. The following example illustrates how full duplex lines could 
“hang” as a result of poor synchronization. 7 : | , 


FORK 10. 
WAIT. 


10: | CONTINUE.. 
WAIT. 


Assume that the primary line executes the FORK 10. At that point, the primary line temporarily yields 
use of the DCP to other lines. The auxiliary line starts up and executes the CONTINUE. Since primary 
control is still at the (fork statement) and is not in a (wait statement), the auxiliary line CONTINUE acts 
asa no-op. Next. the auxiliary line executes the WAIT: When the primary line gets use of the processor _ 
again, it executes its WAIT. At this point, the primary and auxiliary lines are “chung”, each WAITing for a — 
CONTINUE from its co-line. — | | a | na 


“Definitions _ 


REQUEST 


-  Getspace Statement . 


GETSPACE STATEMENT 
Syntax - 


GETSPACE ————— [ ————“¢ abe! > ] —___+-- 


Example 
GETSPACE [10] . 
Semantics 


The (getspace statement) provides the means for a Receive Request to explicitly acquire a message space | 


for input. The message space (if obtained) is linked into the head of the Station Queue, thereby setting 


STATION (QUEUED) to TRUE. If there is no message space available at the time the <getspace 


statement) is executed, control branches to the (abel). If a message space has already. been acquired, this 
instruction acts as a no-op. This statement is also treated as a no-op if it appears.in a Transmit Request. — 
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GO TO STATEMENT 
Syntax 


GO (label) — 


(byte at a ee | > ) 


Examples 
GO 10. 
GOTO 10. — 
GO TO TOGS, (0,1,2,3). 
GO TO STATION (5,9,12). 
Semantics 


The (go to statement) alters the path of control, that is, the sequential flow of statement execution, 
within a (request definition). ss 


GOTO <label) — | 
This form of the (go to statement) unconditionally transfers control to the (label) specified. | 
GO TO <byte variable) . . . es s at ae 


This form of the (go to statement) provides a convenient means of dynamically selecting one or more 
(label) s to which control could branch. The ¢ label) to branch to is selected by using the (byte variable) 
as an index value. If N represents the number of (label)s in the (go to statement), then the (label)s are 
numbered 0 to N-I. The (label) corresponding to the index value is the (label) to which control branches. 
If the index value is greater than N-1, then control continues at the statement following the (go to | 
statement). | 58 ‘<_< *° : 


Supplementary Example 


GO TO STATION (5,9,12). | | | 
% EXECUTION CONTINUES HERE IF STATION > 2. 


5: TOG '0] = TRUE. 
9: TOG [1] = TRUE. | 


12: TOG [2] = TRUE. 
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This example illustrates the GO TO ‘byte variable) construct of the (go to statement). The value of — 
STATION determines the next statement to be executed. If the value of STATION is 0, control branches _ 
to the (label) 5; if the value of STATION is 1, control branches to (label) 9; and if the value of STATION | 
is 2, control branches to (/abel) 12. If the value of STATION is greater than 2, control continues at the _ 
next sequential statement. 3 7 | eee 


‘ Definitions — 


REQUEST 


- If Statement 


rg 


# iF STATEMENT 


ua 


(request statement) > ELSE (request statement). 


(byte variable) 


(integer) LEQ > 


(single character) = EQL (single character) —w 


NEQ =| 
» CEQ 
GTR J 
Examples 
IF TRUE THEN. 


IF TOG [0] THEN TOG $10] = FALSE. 
IF TALLY [0] LSS TALLY [1] THEN TALLY 1 = TALLY aub 
IF CHARACTER = 4“FF“ THEN 
INITIATE BREAK. 
ELSE 
BEGIN > 
CHAR = 400”. 
GO TO 0. 
END. 


Semantics 


The <if statement) causes a. condition (i.e., a Boolean expression) to be evaluated. The subsequent path 


of program control depends on whether the condition i is evaluated as TRUE or FALSE. 


If the condition is TRUE, the ¢ request statement) following the THEN, if present, is executed. ‘Program 
control then resumes at the statement that follows the ¢if statement ). 


‘If the condition is ; FALSE, the request statement) following the ELSE i is cekecuted or, if the ELSE 


request statement) is omitted, program control resumes at the —— statement) enn the 
if statement). : | | | 


The (request statement) can be any egal Gequeat satenen, including the w statement and 
(compound statement). | 


The meanings of the relational operators are contained i in table 55. 


| The following diagrams illustrate the above semantics. : 
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The following diagrams illustrate the above semantics. 


-TRUE 
IF {condition } THEN (request statement) request statement) 
| FALSE : 
TRUE | 
IF { condition} THEN (request statement) ELSE (request statement) (request statement) — 
FALSE — . | _ 
Table 5-5. Relational Operators 
RELATIONAL OPERATOR — MEANING SYNONYMS 
LSS | Less than - | < and LS 
LEQ Less thanor LE 
ee equal to | = & a 
EQL » |, Bqualto | sand EQ 
NEQ | ; Not equalto | NE 
GEQ te Greater than GE 
, or equal to. | | 
{ 


2 GTR 7 Greater than > and GT | 
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INCREMENT STATEMENT 
Syntax — 


INCREMENT C TRAN ——-———- 
| SEQUENCE 


Examples 


INCREMENT TRAN. 
INCREMENT SEQUENCE [SEQERR:10]. 
INCREMENT SEQUENCE [NULL]. 


Semantics | 
INCREMENT TRAN 


This construct of the Gntcrement statement) is only allowed in those (request definition) s in the 
<terminal request statement) s of (ferminal definition) s that contain a (terminal transmission number — 
length statement) defining the transmission number length as nonzero and non-NULL. 


INCREMENT TRAN causcs | to be added to the receive transmission number stored in the Station 
Table when it is executed in a Receive Request, and causes 1 to be added to the transmit transmission 
number stored in the Station Table when it is executed in a Transmit Request. 


The transmission numbers are stored and incremented in EBCDIC. 


If INCREMENT TRAN causes the transmission number to exceed (overflow) the size of the transmission 
number field, the carry is truncated and the result will be zeros (i.e., EBCDIC zeros) in that field. 


INCREMENT SEQUENCE 


This construct causes the sequence number stored in the DCP Station Table to be increased by the value 
of the increment (also stored in the DCP Station Table), providing that the station is in “sequence 
mode”; otherwise, this statement is a no-op. | | 


When using the INCREMENT SEQUENCE construct, provision should be made for taking action if the 
increment caused the sequence number to exceed (overflow) the size of the sequence number field. The 
programmer can take such action by including the optional syntax. Failure to include overflow action 
results in an implicit TERMINATE ERROR if an overflow occurs. 


SEQERR:NULL and NULL are semantically equivalent. These options set the SEQERR (bit variable) 
TRUE, and control continues at the next sequential instruction. 


SEQERR: (label) and (label)are semantically equivalent. They c cause the SEQERR ¢ bit variable) to be 
set TRUE, and control to branch to (label). 


Regardless of whether error action is especie or not, an overflow of the ceaene number field destroys 
the contents of that field. | | 
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Pragmatics 


A station is considered to be in sequence mode whenever its SEQUENCE it variable) is TRUE. : 
SEQUENCE can be sct TRUE only as a result of the Message Control System (MCS) executing the SET/ 
RESET SEQUENCE MODE (TYPE = 49) DCWRITE. In addition, the TYPE 49 DCWRITE also stores 
the starting sequence number and increment in the appropriate ficlds of the DCP Station Table. | 


Sequence mode can be used for any application that the NDL programmer may see fit. Its use, however, 
requires common conventions between the NDL programmer and the MCS programmer. Burroughs 

has utilized sequence mode constructs in two (request defi nition)s of SYMBOL/SOURCENDL: 

- READTELETYPE and WRITETELETYPE. Both require the cooperation of SYSTEM/CANDE to effect’: 
the execution of those statements. ‘The reader is referred to those coat defi ue) as an ce | 
_ of a particular application that Burroughs has implemented. | 
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INITIALIZE STATEMENT 


Syntax 
INITIALIZE BCC 


TALLY —e [ ——e (tally number) ] - 


TOG [ ——_»> (toggle number) ——— | 
Examples | 


INITIALIZE BCC. 
INITIALIZE CRC. 
INITIALIZE RETRY. 


Semantics . 
INITIALIZE BCC 


This construct causes the (byte variable) BCC to be initialized for purposes of accumulating a Block Check 
Character. The value to which BCC is initialized is dependent upon the horizontal parity defined for the 
station’s associated <terminal definition) (in the (terminal definition parity statement) ). If horizontal 
parity is defined as HORIZONTAL:ODD, then BCC is initialized to all ones (i.e., 4°°FF’’). If defined as 
HORIZONTAL:EVEN, then INITIALIZE BCC initializes BCC to all zeros (i.e., 4°00”). 


INITIALIZE CRC 


This instruction initializes CRC to the initial value required for calculating the Cyclic Redundancy Check. 
_ Any (terminal definition) referencing a (request definition) (in the terminal request statement) ) 

that contains this instruction must define the horizontal parity (in the (terminal parity statement) as 
HORIZONTAL:CRC(16); otherwise a syntax error is generated. : 


INITIALIZE RETRY | | 
This instruction causes the value stored in DCP INITIALRETRY to be stored DCP RETRY. 
INITIALIZE TEXT | 


The function of this form is to initialize the message text pointer to zero. When initialized to zero, the 
message text pointer points to the first text character of the message. | | 
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INITIALIZE TRAN 


This form causes zeroes (i.e., EBCDIC zeroes, 4“‘FOFOFO”) to be stored i in the appropriate Transmission 
Number fields of the Station Table. In a Receive Request, zeroes are stored in the Receive Transmission | 
Number field; in a Transmit Request, zeroes are stored in the Transmit Transmission Number field. | 


INITIALIZE TALLY [ (tally number ) J 


This form causes the specified station TALLY to be initialized from the appropriate message header field 
— if a message is present; otherwise the specified TALLY is initialized to zero.. | 


INITIALIZE TOG [ ( toggle number ) | 


This form causes the specified station TOGGLE to Ge initio from the appropriate n message nem if 
a message is present; otherwise the specified TOGGLE is initialized FALSE. | 
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INITIATE STATEMENT 
Syntax 
INITIATE RECEIVE 
TRANSMIT — 
BREAK 
_Examples 
[INITIATE RECEIVE. 
INITIATE TRANSMIT (3 SEC). 
INIT IATE BREAK. 
Semantics 
INITIATE RECEIVE | 
The INITIATE RECEIVE construct causes the adapter cluster to initiate a receive delay calculated for the 
station. After the delay, the hardware is ready to receive information. | | ao - 
The amount of time delayed, referred to as the Initiate Receive delay, is unique to each station andis \ease/ 
calculated at compile-time for each station. The algorithm that the compiler uses to calculate the Initiate tl 
Receive delay is described in the following three paragraphs. — | oso | : 
a. If the ¢ modem definition referenced in the (station definition ) (in the (station modem statement ) 
defines the modem NOISEDELAY as being greater than zero, then the Initiate Receive delay is 
2 milliseconds less than the combined (time)s defined in the (modem noisedelay statemer:t) and 
the (modem transmitdelay statement). | 
b: If the modem NOISEDELAY is defined as zero and the modem TRANSMITDELAY is defined as _ 
being less than 7 milliseconds, then the Initiate Receive delay is zero. a 7 oe 
c. If the modem NOISEDELAY is defined as zero and the modem TRANSMIT DELAY is defined as 
being equal to or greater than 7 milliseconds, then the Initiate Receive delay is the lesser of 15 
milliseconds or | rr ce —_ tie »* 
(1.5 milliseconds + modem TRANSMITDELAY) | 
The NULL option or the (delay time) option can be used to override the calculated Initiate Receive delay. 
NULL immediately readies the hardware so that it can receive information. (delay time) specifies a (time) | 
to be used in place of the Initiate Receive delay. — -? _ "3 
Pragmatics | | 
An INITIATE RECEIVE instruction should precede the first (receive statement) following a transmission. 
If it does not, there is a possibility that execution of the (receive statement) will be delayed for a period . a 
of time of up to 25 milliseconds. The cause of the 25-millisecond delay is described under the semantics | Na 
of the (finish statement). | | | | pO ta | eee 
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INITIATE TRANSMIT 


The INITIATE TRANSMITconstruct causes the adapter cluster to be put ina transmit state after a calcu- 


lated delay. The amount of time delayed is referred to as the Initiate Transmit Delay, and is unique to | _ 


each station. It is derived by taking the greater of the NOISEDELAY (time ) specified for the modem 
configured at the system end, or the TURNAROUND (time) specified by the station’s dterminal 


definition). or | 


This construct must be executed prior to any attempt to TRANSMIT. 


The NULL option or the (delay time) option can be used to override the calculated Initiate Transmit : 
delay. NULL causes the adapter cluster to be put ina transmit state immediately. (delay time) specifies 
a (time) to be used in place of the Initiate Transmit delay. 7 _ 34 & i” 


INITIATE BREAK | | | - 
The INITIATE BREAK construct causes binary zeroes to be transmitted on the line, thus changing the 
state of the line to a “‘spacing” condition. The line remains in the spacing condition until some subsequent. 


instruction causes the adapter: cluster to change the state of the line. Constructs that would change the 
line’s state are INITIATE TRANSMIT, INITIATE RECEIVE, FINISH TRANSMIT, BREAK and IDLE. | 
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PAUSE STATEMENT. 
Syntax 


PAUSE—————_$—$—$—$——$—$———— 


Semantics 


The (pause statement) suspends the (request definition) in a “sleep” state for a minimum period of 
time (200 microseconds for the B 6358 Model II DCP, and 6 microseconds for the B 6350 Model I DCP) 
to allow the DCP to service other lines. It is recommended that a (pause statement) be used in any kind 
of loop that would tie up processor time and thereby prevent the servicing of other lines. The failure to — 
do so results in a high number of timeout faults. 7 4 


Pragmatics 


Instances may occur in which the DCP requires an even greater period of “sleep” to service other lines. 
Repeated timeout faults, despite utilization of the (pause statement), are indications of such conditions. 
A greater period of “sleep” time can be effected by means of a <delay statement), with the Cdelav time) 
specified greater than “sleep” time effected by the { pause statement). : 
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RECEIVE STATEMENT 
Syntax . 
RECEIVE ee: eee 5 aaa ean ak Rien are oredr 
i > NULL ~~~ . as * cee eg J Se ] 
ae time) ® (9 RECEIVE ): >| ERROR [- (witch number) | — +> ]- 8 


| tceaiall 


(switch number) . 


BCC ADDERR 


CHARACTER > BACKSPACE — - — (label) 
CRC - = BCCERR >| [eves | 
TEXT | BREAK | > ABORT — 
TRAN : BUFOVFL 
(string) CONTINUE : 
"} CONTROL — 
CRCERR — 
END —— 
ENDOFBUFFER — 
FORMATERR 
oe, LINEDELETE: 
ae > LOSSOFCARRIER 
PARITY — 
= STOPBIT—— 
[> TIMEOUT——— 
> TRANERR 
=> WRU— 
(ingle character) , 
Examples 
RECEIVE. 
RECEIVE CHARACTER. | 
RECEIVE (3 SEC) ADDRESS (RECEIVE) [0, ADDERR: 10). 
RECEIVE (NULL) [ 
PARITY :999, 
~ LOSSOFCARRIER:999, 
BACKSPACE:NULL, 
END, 
| WRU:NULL | 
RECEIVE CRC [ERROR [1], CRCERR:10]. 
RECEIVE “LITERAL STRING” [FORMATERR: ia! 
RECEIVE EOT SOH. | 
one ~ RECEIVE TEXT [END: 10]. 
we 
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Semantics _ 


The (receive statement) causes the adapter cluster to attempt to receive information from the appropriate 


logical line. 


~The following two syntax items define a maximum amount of time that the ada pter cluster should wait | 
for receipt of the first character, and then each subsequent character, if applicable, before assuming that 

‘the terminal has “timed out.” If neither of these options is included, een tine) defined . 

(in the (terminal timeout statement) ) for the station’s associated terminal type is implicitly used as- 

the (timeout time) in this statement. | _ ee a 

(NULL) | | “« 

This option specifies that the adapter cluster should wait an infinite amount of time. | 

( Xtimeout time) y - | | | a _ 

The (timeout time) defines a (time) that the adapter cluster should wait for a character. If this (time) 

is exceeded before receipt of a character, and the TIMEOUT syntax appears, then the action specified for 

TIMEOUT is taken (refer to TIMEOUT). If the ‘timeout time ) is exceeded and TIMEOUT syntax . 


does not appear, an implicit TERMINATE ERROR is executed. 


The following syntax options define the nature of the information to be received, the amount of © 
‘aformation to be received, and how the information is to be handled. If none of the options are used, it 
is semantically equivalent to specifying CHARACTER (e.g., “RECEIVE.” is semantically equivalent to | | 
“RECEIVE CHARACTER.”). | | yee ee 


ADDRESS 


The proper number of address characters (as defined by the station’s associated (terminal definition) — 

in the Crerminal address size statement )) are received and checked for agreement against the actual . | | 
address characters defined in the (station address statement). If the address characters do not correspond, | 
an address error condition results; if the ADDERR syntax appears, then the specified action is taken. Other- 
wise an implicit TERMINATE ERROR is executed. (Refer to the ADDERR semantics.) - | 


ADDRESS (RECEIVE) 


This option is equivalent to ADDRESS, except that ADDRESS (RECEIVE) must be used when an address : | 


pair is defined in the (station address statement) and the programmer neéds to check for the proper 

receive address. | | | - > & 7 

ADDRESS (TRANSMIT) _ rae 7 7 7 eS | 

— This option is equivalent to ADDRESS, except that ADDRESS (TRANSMIT) must be used. when an : 
address pair is defined in the (station address statement) and the programmer needs to check for the proper 
transmit address. | = 7 oo oe Se 4 | - , 
BCC 


One character is received and checked against the. (byte variable) BCC. If the character received and 
BCC are not equal, a Block Check Character error condition results; if the BCCERR syntax appears, 
then the specified action is taken. Otherwise an implicit TERMINATE ERROR is executed. , 
Presumably, if the RECEIVE BCC construct appears, the programmer has defined horizontal parity in 
the (terminal parity statement) , and the accumulated: Block Check Character is contained in BCC. 
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‘CHARACTER 


One character is received and stored in CHARACTER. | 


\ 


Two characters are received. The first character is checked against: CRC [0], and the second compared 
against CRC [1]. If the characters reccived and CRC are not equal, a Cyclic Redundancy Check error : 


condition results: if the CRCERR syntax appears, then specified action is taken. Otherwise an implicit im 
TERMINATE ERROR is executed. | : | Ss a 


Presumably, if.the RECEIVE CRC instruction appears, the programmer has defined horizontal parity | 
as HORIZONTAL:CRC(16) in the (terminal parity statement), and the Cyclic Redundancy Check is | 


contained in CRC [0] and CRC [1]. 
TEXT | - 


\ 


Characters are received into CHARACTER and stored in the text portion of the message space obtained 


until either a syntax option results in a branch from the (receive statement) , or a non-recoverable elror, 


such as a disconnect, occurs. If the occurrence of a particular character results in a branch outside of the 
(receive statement > (as specified by a syntax option), then that character is not stored but remains in © 


CHARACTER. | a —- 
The RECEIVE TEXT construct is, in effect, the same as the following loop: : 


1: RECEIVE CHARACTER. 
STORE CHAR ACTER. — 
GOTOL, ree ee ee | 

In nearly all cases, the: (receive statement) should contain optional syntax to avoid the “endless” loop — 

and an eventual implicit TERMINATE ERROR as a result of a timeout, end-of-buffer condition, etc. 


TRAN 


The proper number of transmission number characters (as defined by the station’s associated Germinal 
definition) in the (terminal transmission number length statement) ) are received and checked for agree- 
ment with the Receive Transmission Number maintained in the DCP Station Table. If the characters 
received and the Receive Transmission Number are not equal, a transmission number etror results. If the 


is executed. 


"TRANERR syntax appears, then specified action is taken; otherwise an implicit TERMINATE ERROR © 


(string) 


The number of characters as indicated by the length of the (string) are received and checked against thos« 
characters in tie (string). If the <string) and the characters received are not equal, then a format error 


- condition results. If the FORMATERR syntax option appears, then that action is taken; otherwise an 
implicit TERMINATE ERROR is executed. — | os “3 eB on 


The following syntax options specify actions to be taken upon either the receipt of defined characters . 
or occurrences of specific error conditions. ee ee ae ke ee a oli 
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ERROR [ (switch number) | 


This syntax option associates a previously defined Error Switch with the (receive statement). This allows ~ 
the programmer to associate a set of previously defined crror actions with the Creceive statement) , thus 
reducing the amount of coding required for each (receive statement). BREAK, BUFOVFL, | 
LOSSOFCARRIER, PARITY, STOPBIT, and TIMEOUT syntax options are not allowed if the ERROR 

[ (switch number) | syntax appears in the (receive statement). Refer to the error switch statement) 

for more information. | , | _ . oo 7 _— 


(switch number) | 
Semantically equivalent to ERROR [ (switch number)y 1s * 
ADDERR | ye 


The ADDERR option variations cause the following actions if an address error is detected when an attempt 
is made to receive a terminal’s address characters: . or 7 | 


ADDERR sets TRUE the ADDERR (bit variable) and 
a | branches control to the next sequential 

| statement. — | | | | 
ADDERR:NULL er, oe causes no action. Execution proceeds as if the 


‘error condition did not occur. 


ADDERR: (label) ~ sets TRUE the ADDERR (hit variable) and 
a oo | | ‘branches control to (label). 3 
ADDERR:ABORT = : not allowed. 7 
BACKSPACE | | _ 


The following BACKSPACE option variations cause the following actions if the terminal’s backspace | 

character (as defined by the <terminal backspace character statement)) is received: 2 

BACKSPACE a 4 a moves the message text pointer backwards one 
| i : character position, and branches control to the — 

| | ae | next sequential statement. . os 
-BACKSPACE:NULL Oo | moves the message text pointer backwards one 
| | | | character. Control remains within the (receive 
statemen t) if of the form RECEIVE TEXT. _ 


BACKSPACE: (label) ss ~ | moves the message text pointer backwards one 
| | : -_ _, character, and branches control to (label). . 
BACKSPACE:ABORT ==———__notallowed. 
BCCERR | | | | | | 


The following BCCERR option variations cause the following actions if the character received is not equal to - 
the data stored in. BCC. ee oO i ee os : 


BCCERR | sets TRUE the bit variable, BCCERR, and 
| | 4s branches contro! to the next sequential 
| | statement. _ | . 7 
BCCERR:NULL) 7 | | causes no action. Execution proceeds as if the 


error condition did not occur, - 


§-112 


- ; CONTINUE: ABORT 7 as : 2 8 ——- not allowed. 


Definitions — 
| REQUEST 
Receive Statement — Continued 


BCCERR: (label) ~ sets TRUE the (bit variable) BCCERR and 
| | _ ___ branches control to 0 (label). 
BCCERR:ABORT not allowed. 
BREAK | 


The BREAK option variations cause the following actions as if a break, that i is, at least two character-times 
of a spacing line condition, iS detected by the adapter cluster while receiving: 


BREAK ——- eo state, *4 sets TRUE the aa variable) E BREAK | = 
| a see | "i ie [RECEIVE], and branches control to the next 
sequential statement. 


BREAK:NULL " 2. wh a causes no action. Execution proceeds as if the 

_ . ‘a Fe break did not occur. a. 

BREAK: (label) - . 3 sets TRUE the bit variable) B BREAK —_ 
et (4 & _*. Va": oe [RECEIVE], and branches control to (label). 
-BREAK:ABORT = © ~———__ sets TRUE the (bit variable) BREAK: 

“Gah | = [RECEIVE], and: executes 2 an. nr 

| TERMINATE ERROR. 
| BUFOVFL 


The following variations of the BUFOVFL eption cause the following actions if the 2 DCP i is ingbles to service ‘ 


_a Cluster Attention Needed (CAN) eh peter the ae Cluster receives another character (thus | 


destroying the previous character): 


_ BUFOVFL Soe fe | sets TRUE the (bit igi BUFOVEFL, and 
| 7 get _.- branches control to ane next sequential 

| | : .. statement. & . | 

BUFOVFL:NULL © | - causes no action. Execution Ptoceeds as if the 

| Oo | or » 3 __- error condition did not occur. | 
-BUFOVFL:<label) 2 | | _ sets TRUE the dit variable) BUFOVF L, and 
se Se ee ee | =» branches control to (label). : 
‘BUFOVFL:ABORT = ~=—__ sets TRUE the (bit variable) BUFOVFL, and 


2 . executes : an implicit TERMINATE ERROR. 
CONTINUE | | 


This item is allowed only in (receive itateiianitie of control definition) s and (request defi nition) s that are- 


_ written to communicate with full duplex terminal types. CONTINUE syntax causes.action as described 
below if the co-line executes a ce tinue veiannsi Aes before all information specified by the en | 


statement) is received. 


‘CONTINUE | a - pine ty oe siahehes eel to the next t sequential ae 
_ a = | me a a a statement. eer b @ x —T. 
| CONTINUE:NULL | 7 oe - ~~ causes no action: ‘Bxéoution proceeds as if the 
—_ - ae ee OS - Continue statement) had. not been executed. 
| CONTINUE: abel) re ost: branches control to ) (abel). | 
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CONTROL | 


The following variations of the CONTROL solion Cause the following ictions if the Seuntvel character of: 
the station ( as defined in the (station control charac ter statemtent) ) is received: 3 


CONTROL | 3 - sets TRUE the (bit variable) CONTROLFLAG,. 
= ae a and branches control to the next sequential 
a | ae | | statement. | | 
CONTROL:NULL _ _ *e "sets TRUE the ee wiaeis CONTROL FLAG, 


and execution continues if the character was 
not the station’ s control character. 


CONTROL: Katiel) ae a sets TRUE the (bit variable) CONTROLF LAG, 
. = and branches control to (label). 
ia a ABORT _ es not allowed. 
CRCERR _ | 


The following variations of the CRCERR apiion cause the following actions if the first character received | 
— does not equal CRC [0], or the second character received does not equal CRC [1]. 

(This item is appropriate ony for the RECEIVE CRC construct of the er stent)» refer to the 
CRC option.) . | 


CRCERR -* sets TRUE the (bit variable) CRCERR, and 
ee | | _ branches control to the next sequential statement. 


CRCERR:NULL a att cause no action: Execution proceeds a as if the 
Oo = § a error did not occurr: ae ee eee 
CRCERR: (label)  e st sets TRUE. the bit variable) C CRCERR, andl oe 
ie he | _-._ branches control to (abel). | 
CRCERR:ABORT oe are not allowed. 
END © | | | 


The following variations of, the END option cause the following actions if the “end” enaacter of jie: 
station (as defined by the alae end character statement). in the ee el weg ts associated . 
with the station) i is receive | | | = . * | 


END  3=— -* ee pate 2 on see sonteol to branch to the next sequential | 
; : - | are statement. | ae ee eo 
END:NULL a causes no. action. Execution proceeds as if the 
woe. re ee character was not the “end” character. 
END: abel) i rs : branches control to (label. 
END: ABORT nt allowed. 
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ENDOFBUFF ER 


- This syntax item is allowed in the RECEIVE TEXT contruct of the (receive statem nt). The variations of 
the ENDOFBUFFER option shown: below cause oe following actions if either of the loflowing conditions 
arises: 


a. ‘There is no message space and an attempt is made to store information ne a message 
space (the store function is an implicit action of the RECEIVE TEXT construct), or 


—b. The number of characters stored j in the message excéeds the maximum allowed (the | 
maximum is defined. by either the es maxinput —, or the nr 
buffer size statement)). | 


ENDOFBUFFER iat‘ CC~sSCSCC. Sets TRUE the it variabléy ENDOFBUFFER, 
| | : and branches control to the next sequential | 
| a statement. | <= . we | 
ENDOFBUFFER:NULL 7 | causes no action. Pxecution proceeds as if the 
| _* 4&4 | ee _. error did not occur. _— tet By 
_ ENDOFBUFFER: (Jabel) _ sets TRUE the. (bit variable) ENDOFBUFFER, 
= faa | 2 and branches control to (label). | | 
‘ENDOFBUFFER:ABORT = = = = =—_-_ not allowed. 
FORMATERR 


The following variations of the FORMATERR option « cause © the following actions if the chamacters received 
are not equal to those in the —s (this item is appropriate eat is or the RECEIVE er construct 
of the (receive statement) J: | | 


FORMATERR = ~~ ~—___ sets TRUE the vit cae FORMATERR, 
| 3 and branches control to the next eeavential 
| _. ie | Statement. Mis | 
FORMATERR:NULL a OO | causes no action. Execution proceeds as if the 
| a _ error did not occur, 
FORMATERR: (/abel) | sets TRUE the (bit variable) FORMATERR, 
and branches control to (label). 7 
FORMATERR: ABORT 2 not allowed. 
LINEDELETE ean « | 


The following variations st the LINE DELETE option cause. the foliowine actions if the station’s 
linedelete character is received (the LINEDELETE aces is s defined vue the Salas linedelete” 
character statement) ): 7 


_ LINEDELETE. eee se, “alters the value of the message text pointer to ae 
| “pint to the first character position in the message 
text, and branches one to the next sequential _ 


statement. 


LINEDELETE:NULL . ft a oe 2 ‘alters the value of the message en pointe to. 
| a ae ae ae od point to the first character position in the message" 
text,'and execution proceeds as if the character 
was not the linedelete character. pie 
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LINEDELETE: (label) | alters the value of the message text pointer to 
| | | 7 — point:to the first character position in the message — 
| . ae | text, and branches control to (label). 
LINEDELETE: ABORT 7 not allowed. | 
LOSSOFCARRIER - i 


The following variations of the. LOSSOFCARRIER syntax cause ‘the following actions if a loss of carrier 
is detectcd while receiving. | 


LOSSOFCARRIER gets TRUE the (vit variable) | LOSSOFCARRIER, 

| re or ne : if 3 and branches control to the next sequential 

| - | _. Statement. 
LOSSOFCARRIER:NULL ae | causes no action. Execution proceeds as if the 
| - 7 a | error did not occur. | 

LOSSOFCARRIER: (abel) == ——Ss sets TRUE the (bit variable) LOSSOFCARRIER, 

OG io * SS a ae, | <3 and branches control to (label). | 
LOSSOFCARRIER: ABORT | | | sets TRUE the (bit variable) LOSSOFCARRIER, 


~ and executes an implicit TERMINATE ERROR. 


There is one exception to the actions described abewe: If a loss of carrier is detected while receiving, and | 
if the terminal is modem-connect, and if the terminal’s (station definition) references a (modem definition) —_ 
that contains the construct LOSSOFCARRIER=DISCONNECT, then an tana disconnect is done, | 
regardless of the action specified. 


PARITY 


The following variations of the PARITY option cause the following g actions ifa 1 parity bit. error is detected 
by the adapter cluster: | | | 


PARITY _ - sets TRUE the ea variable) PARITY, and 
Pe, _ | branches control to the next sequential State- 
| ment. | . 
- PARITY:NULL | | a. causes no qclibits: Execution proceeds as if the 
| | ee error did not occur. | 
PARITY: (abel) a sets TRUE the bit a PARITY, and 
- branches control to (label). a 
‘PARITY: ABORT | ae fs | - sets TRUE the <bit variable PARITY, and 


‘ executes a eN EI tROR. 
STOPBIT 


The following variations of the PARITY option cause the described actions if a stop bit error is s detected 
by the adapter cluster: 


STOPBIT Oo sets TRUE the bit variable) and branches control 
_ 3 | ) | to the next sequential statement. 


STOPBIT:NULL _ | - causes no action. Execution proceeds as if the 
_ : _ error did not occur. | 
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STOPBIT: label) = | __ sets TRUE the Coit variable) STOPBIT, and 
- * | branches control to abel). 
STOPBIT:ABORT o* sets TRUE the (bit variable) STOPBIT, and. 


executes a. : TERMINATE ERROR. 
TIMEOUT . | 


The vanations of the TIMEOUT sviilak shown below cause the actions described if the time requited to 
receive a character exceeds the (timeout time). The (timeout time) is defined in the (terminal timeout. 
statement) , but can be overridden by including the (( timeout — ) or rene a options in the 
(receive statement). | 


TIMEOUT ef we : sets the (bit variable TIMEOUT: ia branches 
-_ os ; . 2 ae control to the next sequential statement. 


TIMEOUT:NULL | - _ causes no action. Execution procerds as if the 
| | ee ni ee. f error did not occur. - 2 
TIMEOUT: (abel) a: _ sets TRUE the (it variable) TIMEOUT, and 
ee bganches control to (abel), 
TIMEOUT:ABORT © ————«ss—s—SC=Csets TRUE the (bit variable) TIMEOUT, and 
| eS x + executes a TERMINATE ERROR. — 
TRANERR 


The following Variations of the TRANERR option cause the described actions if the characters received 
and the Reccive Transmission Number stored in the Station Table are not al ( this item is allowed only 
in the RECEIVE TRAN ala of the dicate — | and 


TRANERR | a sets TRUE the ne “arabic 1 TRANERR, and - 
. 7 . ‘branches control to. ne next ill state- 
TRANERR:NULL Se oe causes no action. “Execution proceeds as if the 
aa 2.28 7 error did notoccur. 2 7 
TRANERR: (abel) a ae sets TRUE the bit nal) TRANERR, and : 
oa, branches control to © Cabel). - 3 
qi TRANERR: ABORT | 7 a oe not allowed. e 


The following variations of the WRU ayntes cause the following acticts if the WRU character of the % 
station is received (the boroet WRU CraactEl er statement) defines the WRU character): i 


— WRU ite se Se oS oo . gets TRUE the. WRU (bit variable) , ana Branches | 
po alt eek fe te So +.) control to the next sequential statement. 

WRU:NULL —°= © sets TRUE the WRU (bit variable) , and execution 

ae ae --. +» * proceeds as if the character received was not the 

eB oo ae | | WRU character. — - | 

WRU: (label) a sets TRUE the (bit vrabl) ¥ WRU, and branches 

ee a! en ce control to (abel). 
-WRU:ABORT == ss—(asi‘ts—s—SCSCSCSCSéitotalloeed. 
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(single character) 


The following variations of the (single character) syntax cause the following actions if a character received 
is equal to the single character : - | | 7 ; : -_ 


(single character) nn: ~ branches control to the next sequential state- 
3 7 ment. _ ws he gg | 
(single character):NULL | rr causes no action. Execution proceeds as if the 
ee | _ character received was not equal to the (single _ 

| ~ a _ character). c ier 
(single character): (label) | _ branches control to (label). - 
(single character) :ABORT | 7 not allowed. | 


The allowable combinations of the (receive statement) syntax options are defined in table 5—6 below. 
The (NULL) and. ( (timeout time) ) options are allowed in any construct of the (receive statement). 
Allowed:combinations of the other syntax options are denoted by a ‘“‘X”’ in the appropriate columns 
and rows. = | a oe | | ae 


Table 5-6. Allowable Combinations for (receive statement) F 


se oe eae zo, 
is: ie 4 = 3 
os)  . fe - ie | — Ss 
seulee Eger ess 7 
| Of | 7 D) bet Ca = 
5 8 Bee ues a p2322 
ESESSSREZESSSEEREES 
ADDRESS ss: X X XX * xX XxX 
ADDRESS(RECEIVE) | X = XXX XXX X_ 
ADDRESS(TRANSMIT) | X  ###$X XX : XX XX 
BCC | XXXX XXX X_ 
CHARACTER fF X XXX xX" X. XX XXX .XX 
CRC — XXK KK KXKXK 
TEXT KS XX KX RX KKKXKXKX XX. 
TRAN | XXX oo KX XXX 
(string) XXX =. KX XKXXKXK 
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RECEIVE (3 SEC) [TIMEOUT: 10]. 
RECEIVE ADDRESS | ADDERR:99]. 


RECEIVE CHARACTER [CONTINUE:10, 
| CONTROL:20, 
TIMEOUT:30, 
840), 


RECEIVE [ERROR[0]]. 
RECEIVE [0]. 


RECEIVE (1 SEC) TEXT [LINEDELETE:NULL, 
~ CONTROL:NULL]. 


Definitions 
REQUEST 


Receive Statement - Continued | 


Explanation 


Causes the adapter cluster to attempt to receive a 
character. If the character is not received within 
3 seconds, the (bit variable) TIMEOUT is set 
TRUE and control branches to 10. | 


if the character(s) received do not equal those 
defined in the (station address statement) . the 
(bit variable) ADDERR is set TRUE, and control 
branches to 99.. “a oe 


This statement would only be allowed in a 
(control definition) or (request definition) that 
is written to communicate with full duplex | 
terminal types, because it contains the CONTINUE 
item. - 


CONTINUE:10 would cause a branch to 10 if the 
co-line (control definition) executes a (continue 
statement) before a character is received. 


CONTROL:20 would set CONTROLFLAG TRUE 


_and branch to 20 if the character received is the 


station’s control character. 


TIMEOUT:30 would sect TIMEOUT TRUE and 
branch to 30 if a character is not received within 
the (timeout a defined in the (terminal 
timeout statement) . | 


“°?-40) would cause a branch to 40 if the 
character received is the asterisk character. 


An attempt is made to reccive one character and 
store it in CHARACTER, If any errors described 
in the associated error switch statement) occur 
while receiving, then the action defined in that 
(error switch statement) istaken. 


- Anattempt is made to receive one character and 


store it in CHARACTER. If any errors described 
in tie associated error switch statement) occur 


while receiving, then the action defined in that 


<error switch statement) is taken. 


LINEDELETE:NULL causes the message text 
pointer to be set to the first character position if 
the linedelete character (as defined in the 
(terminal linedelete character statement) is 
received, and characters continue to. be received 
and stored in the message text beginning at the 
first character position. 
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Statement oe | Explanation 


CONTROL:NULL causes the (bit variable) 
CONTROLELAG to be set TRUE if the control | 
character of the station (defined in the (station 
control character statement)) is received,and) - 
characters continue to be received. - 
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SHIFT STATEMENT 
Syntax 


lc awheuieaie 
| : DOWN 


Semantics 


The (shift statement) is to be used in a (control defi nition) that communicates with stations using the 
Baudot (5-bit) character code set. (The character code set is defined in the (terminal code statement): 
of the associated (terminal definition).) — 


SHIFT UP indicates that received characters are to be translated to their respective uppercase graphics 
(usually referred to as FIGS). | 


SHIFT DOWN indicates that received characters are to be translated to their ReSPeCHiVe lowercase graphics — 
(usually referred to as LTRS). 


If the station does not use Baudot code, the (shift statement) acts as a no-op. 


Pragmatics 


In the Baudot sianictet code set, most bit patterns have two graphic representations; one is referred to . | 
as FIGS (the uppercase graphic), ‘and the other as LTRS (the lowercase graphic). _ 


When transmitting to a terminal that uses Baudot code, the terminal prints LTRS until it 1 receivesa 


specially designated character indicating that it should shift to printing FIGS. The terminal continues 
printing the FIGS until it receives a specially designated character indicating that it should resume Pane | 


the LTRS. 


When information is received from a terminal that uses Baudot, the same conventions hold true; that is, 
the terminal communicates whether FIGS or LTRS follow, Oy the transmission ofa designated character. | 
The terminal initially transmits LTRS. 
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STORE STATEMENT = 
Syntax 
STORE | oa _ 
> CHARACTER—* ‘es | CaS | MACE 
> (string) ENDOFBUFFER-> : (label) | 
SEQUENCE 
= TALLY ————_- [ —-(tally number) ———> | 
: TOG ————_——> | ______»-(toggle number) | 
Examples 
STORE. co 
STORE CHARACTER [ENDOFBUFFER:20]. _ 7 | | : 
STORE “ABC” [NULL]. | —_ 7 , | a 
STORE SEQUENCE. | | | wus! 


STORE TALLY [0]. - 
STORE TOG [0], TOG [1], TALLY [0]. 


Semantics 

STORE | | 

This form is semantically equivalent to the STORE CHARACTER construct. 
STORE CHARACTER | 


This form causcs the data contained in CHARACTER to be stored in the message space. If no message: 
space is associated with the <request definition) , then an implicit (getspace statement) is executed. 
The data is stored in the character position pointed to by the message text pointer, and the text pointer 
is updated after the STORE to point to the next forward character position. | 


It is possible to encounter the end-of-the-text buffer when using this instruction. It is recommended that 
the optional syntax be included whenever using this statement. The optional syntax specifies action to be 
taken if the end of buffer is encountered. The NULL option specifies that the only action that should be 
taken is to set ENDOFBUFFER to TRUE. The (label) option specifies that the only action that should be 
tered, control should branch to (label) and also set ENDOFBUFFER TRUE. The ENDOFBUFFER: part 
can be included for documentation. An implicit TERMINATE ERROR is executed if no end-of-buffer 
action is specified. | | = 


STORE (iring) 


This form causes (string) to be stored in the message space. If no message space is currently associated — 
with the (request definition) ,an implicit getspace instruction) is executed. The (string) is stored = os 
in the message space beginning at the character position pointed to by the message text pointer, and the 4 
text pointer is updated after the STORE to point to the first character position following the (string) . 
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This instruction uses CHARACTER as a temporary storage area to store each character of rig. Thus, 
any data in CHARACTER prior to a STORE (string) instruction will be destroyed. | | 


It is possible to encounter the end-of-the-text buffer when using this instruction. Therefore, it. is | 
recommended that this instruction include the optional syntax. Refer to the STORE CHARACTER -. 
construct for the semantics of this syntax. 


STORE SEQUENCE 


Providing the station is in sequence mode (i.e. , SEQUENCE is TRUE), the STORE E SEQUENCE 

construct causes the current value of the sequence number to be stored in message word [5] .[26: 271 

is a binary integer, and message word [5] .[27.1] is set TRUE to indicate its presence. If the station 

is not in sequence mode (i.e., SEQUENCE is FALSE), then the instruction is a no-op. If no message space 
is present at the time of the STORE, then an implicit (getspace instruction) is executed first. 


STORE TALLY [ (tally number) | 


This form causes the TALLY specified to be stored in the message space header. If no message space is 
present, an implicit (getspace statement) is executed just prior to the store operation. 


STORE TOG [ <foggle number) ] 


This form causes the TOGGLE specified to be stored in the message space header. If no message space 
is present, an implicit (getspace statement) is executed just prior to the store eperenon: 


Pragmatics 


The application of the STORE TALLY and STORE TOG constructs rests solely with the programmer. 

Since the message spacc is usually returned to a Message Control] System (MCS), some mutual - 

convention could be established between the NDL programmer and the MCS programmer as to the meaning 
of the contents of the TALES and TOGGLEs. 
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SUM STATEMENT 


Syntax 
SUM 
> Al. 
> BCC 
> CHARACTER - 
> RETRY 
= TALLY ———————— | tally number) ——>] 
(single character) | 
Examples 
SUM AI. 
SUM CHARACTER. 
SUM “A”. 


SUM TALLY [1]. | 
Semantics | 


The purpose of the (sum statement) is to affect the calculation of the horizontal parity check (whether 
that be a Block Check Character. or a Cyclic Redundancy Check). The specific effect of the (sum state- 
menty is dependent upon two factors: The SUMmed item, and whether the station’s (terminal 
definition) , for which (request definition) is running, defines horizontal parity as CRC(16). Following 
is a description of the effect that each form of the (sum statement) has on the calculation of the © 
horizontal parity check. 


SUM 
Semantically cquivalent to SUM CHARACTER. 
SUM AI. | 


If the horizontal parity check is a Block Check Character or is undefined, the contents of Al are 
exclusively OR-ed with the contents of BCC, and the result is stored in BCC. 


If the horizontal parity check is a Cyclic Redundancy Check, the Cyclic Redundancy Check algorithm is 
~ computed with the contents of AT and CRC, and the result is stored in CRC. | 


SUM BCC 


If the horizontal parity check is a Block Check Character or is undefined, then the contents of BCC 
are exclusively OR-ed with itself, and the result is stored in BCC. (The result in BCC would be zero 
in this case.) 3 | | 


If the horizontal parity clieck is.a Cyclic Redundancy Check, the Cyclic Redundancy Check algorithm is 
computed with the contents of CRC[0] and CRC, and the result is stored in CRC. 7 | 


SUM (single character) 


Definitions = 
— Sum Statement — Continued 


SUM CHARACTER 


are exclusively OR-ed with the contents of BCC, and the result is stored in BCC. 


If the horizontal parity check is a Block Check Character or is undefined, the contents of CHARACTER | - 


If the horizontal parity check is a Cyclic Redundancy Check, the Cyclic Redundancy Check algorithm is 
computed with the contents of CHARACTER and CRC, and the result is stored in CRC. — | 


SUM RETRY 


if the horizontal parity check is a Block Check Character or is undefined, the contents of RETRY are 
exclusively OR-ed with the contents of BCC, and the result stored in BCC. Fees 


If the horizontal parity check is a Cyclic Redundancy Check, the Cyclic Redundancy Check algorithm is 
computed with the contents of RETRY and CRC, and the result is stored in CRC. ea | 
SUM TALLY [(¢ally number) ] 


If the horizontal parity check is a Block Check Character or is undefined, the contents of TALLY | 
[ <tally number) | are exclusively OR-ed with the contents of BCC, and the result is stored in BCC. 


If the horizontal parity check is a Cyclic Redundancy Check, the Cyclic Redundancy Check algorithm is — 
computed with the contents of TALLY [ <tally number) | and CRC, and the result is stored in CRC. 


If the horizontal parity check is a Block Check Character or is undefined, the single character) is : 
exclusively OR-ed with the contents of BCC, and the result is stored in BCC, | | 


If the horizontal parity check is a Cyclic Redundancy Check, the Cyclic Redundancy Check algorithm is 
computed with the (single character) and CRC, and the result-is stored in-‘CRC. | | , eee 
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TERMINATE STATEMENT 


Syntax 

TERMINATE 
> BLOCK 
> ENABLEINPUT 
> ERROR— 
> LOGICALACK 

> (RETURN) — 

> NOINPUT 
= NORMAL 

Examples | 

TERMINATE NORMAL. 


TERMINATE LOGICALACK. 
TERMINATE LOGICALACK(RETURN). 
TERMINATE. | 


Semantics 
Fach form of the (terminate statement) is described in the following paragraphs. 
TERMINATE 


This construct causes control to branch from a (request de ofinition) and to begin executing the appropriate 
(control definition). Any message that may be queued is left in the Station Queue (regardless of whether 
the message is incoming or outgoing) and STATION(QUEUED) 1 is untouched. 


TERMINATE BLOCK 
In a Receive Request, this construct causes the following actions: 


a. an implicit (getspace instruction) is executed (in case the (request defi nition) ‘may have been 
terminated without ever having acquired a message space); 


b. the Error Flag field, Last Flag Set field, and DCP RETRY are stored into the appropriate 
message fields; 


c. the “More-Blocks-to-Follow” bit (programmatically referenced by BLOCK) i in the message | 
(message word [0]. [29: 1]) is set TRUE; 


d. the message is delinked from the Station Queue and linked into the DCP Result Queue; aiid 
e. control continues at the next sequential statement. 
In a Transmit Request, the TERMINATE BLOCK construct causes the rSilowine: 


a. the Error Flag field, Last F lag Set field, and DCP RETRY | are stored into the appropriate 
message fields; 
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the message ts linked into the DC P Result Queue: and 


c. the ( request definition) is continued at the next sequential statement if STATIONQUEUED) 
is TRUE; otherwise, the (request definition) is suspended and put in a “sleep” state: until 7 
ST ATION(QUEUED) becomes TRUE. | 
TERMINATE ENABLEINPUT 


This construct is allowed in Transmit Requests only. 


This instruction causes the following actions: 


a. 


C. 


d. 


the STATION(ENABLED) bit is tested; if ST ATION(ENABLED) is FALSE, then this instruc- 
tion acts as a no-op; otherwise, steps b through d are executed; 


the Error Flag field, Last Flag Set field, and DCP RETRY are stored into the appropriate 
message ficlds; 


the message is linked into the DCP Result Queue; and 


control Icaves the Transmit Request and the station’s Receive Request is entered. 


TERMINATE ERROR 


This construct serves to inform the station’s MCS of an unsuccessful attempt to écinpicies a Receive or 
Transmit Request. This instruction inhibits the initiation of any new functions for the station. 


The result of the TERMINATE ERROR construct is as follows: 


STATION(READY) Dit variable is set FALSE; 


a minimum-size message space is obtained, filled with error information for the MCS, and linked 
into the DCP Result Queue (its destination being the MCS); and. , 


the line is idle until the MCS takes some action. 


Additionally, if the TERMINATEing (request definition) was a Receive Request, any message space that 
may have been acquired to store a RECEIVEd message is discarded. | 


The error message sent to the MCS contains the following information: 


MSG[0].[47:8] = 99. 


[39:8] = AC Register contents. 
[31:8] = AI Register contents. 
[23:24] = Logical Station Number. 


MSG[1].[47:8] = Result Byte Index 


[39:6] = Line status prior to TERMINATE ERROR. 
[33:1] = LINE(TOG[1]). 

[32:1] = LINE(TOG[0}). 

[31:8] = Last Flag Set in MSG[1].[23:24] 

[23:24] = Error Flag field. 
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MSG[2].[47:8] = CHARACTER, 


[39:16] = Last DCP “Sicep” address. 


MSGI4].[ 23:24] = Original DCWRITE TYPE. (Contains the original contents of MSG[0].[47:24] 
prior to presentation of the message to the DCP.) pe aay, 


Refer to appendix E, “The Error Result Message,” in the B 6700/B 7700 DCALGOL Reference Manual, : 
form number 5000052, for more information regarding this message. - 7 


TERMINATE LOGICALACK 


This construct is allowed in Receive Requests only. This instruction tests the LOGICALACK bit.in the 
Station Table. (The semantics of the (station logicalack statement) describe how the LOGICALACK bit 
is set.) If LOGICALACK is FALSE, the instruction acts as a no-op and control continues at the next 
sequential statement. If LOGICALACK is TRUE, the following occurs: 


a. animplicit (gcispace statement) is executed (in case the (request definition) is terminating 
without ever having acquired any message space); : 


b. the ACKNOWLEDGEREADY bit in the Line Table is set (the consequences of this action are 
described subsequently ): = 


c. the “Message to be ACKNOWLEDGEd” bit is set in the Error Flag Field; 


do the Error Flag Field, Last Flag Set Field, and DCP RETRY are stored into the appropriate 
message fields; | | 3 


ce. the message is delinked from the Station Queue and linked into the DCP Result Queue; 


f. the line is put in a “‘sleep” state until the station’s MCS responds to the message with an 
ACKNOWLEDGE (TYPE = 44) DCWRITE; and : 


upon receipt of the ACKNOWLEDGE, the Receive Request is allowed to continue at the 
next sequential statement. “oe 


oi) 
. 


The ACKNOWLEDGEREADY bit is inaccessible to the NDL programmer, and it exists for each logical 
line in its Linc Table. The only time that this bit will be TRUE is when a station’s LOGICALACK bit is 
TRUE and its Reccive Request has exccuted the TERMINATE LOGICALACK construct or the 
TERMINATE LOGICALACK(RETURN) construct. Once TRUE, the ACKNOWLEDGEREADY bit will 
not be set FALSE, and the (request definition) will not be allowed to continue until the MCS executes. 
the ACKNOWLEDGE (TYPE = 44) DCWRITE. | | 


TERMINATE LOGICALACK(RETURN) 


This construct is allowed in Receive Requests only. This instruction tests the LOGICALACK bit in the . 
Station Table. (The semantics of the (station logicalack statemen t describe how this bit gets set.) If this. 
bit is found TRUE, this statement functions exactly as does TERMINATE LOGICALACK; refer to that 
form for semantics. If LOGICALACK is FALSE, the following occurs: - : 


a.  animplicit (getspace statemen ry is executed (in case the (request definition) is terminating 
without ever having acquired a message space); 


b. the Error Flag field, Last Flag Set field, and DCP RETRY are stored into the appropriate message — 
fields; | 7 


c. the message is delin ked from the Station Queue and linked into the DCP Result Queue; and 


d. control continues at the next sequential instruction in the (request definition). 


Definitions | 
REQUEST 


Terminate Statement — Continued | 


TERMINATE NOINPUT 


If exccuted in a Transmit Request, this form is semantically equivalent to the TERMINATE construct (refer 
to that construct for semantics). When executed ina Reccive Request, the following occurs: _ 


a. any message space that may have been acquired is discarded, 
b. LINE(BUSY) is set FALSE; and | 
c. control branches to the appropriate (control definition). 


TERMINATE NORMAL 


The purpose of this construct is to signal the satisfactory completion of a (request definition). \f executed 
in a Receive Request, the following occurs: 4 
a.  animplicit (getspace statemen t) is executed (in case the Grequest definition) is terminating | : 
without having ever acquired a message space); — | oe 


b. the Error Flag field, Last Flag Set field, and DCP ENTRY are stored into the appropriate _ 
message fields; 7 | a 


c. the message space is delinked from the Station Queuc and linked to the DCP Result Queue: 
d. LINE(BUSY) is set FALSE; and | | 4 a 4 


ce. control branches from the (request definition) and (providing the DCP does not take advantage 
of LINE(BUSY) set FALSE to initiate a (request definition) ) the appropriate (control — 
definition) is entered. — oe 


If TERMINATE NORMAL is exccuted in a Transmit Request, the following occurs: 


a. _ the Error Flag field, Last Flag Set field, and DCP RETRY are stored into the appropriate message 
ficlds; 7 os | 


b. the message is linked into the DCP Result Queue; 
c. LINE(BUSY) is set FALSE; and 


d. control branches from the (request definition) and (providing the DCP does not take advantage 
of LINE BUSY) set FALSE to initiate a (request definition) the appropriate (control definition) 
is entered. : 


In the Transmit Request case, the message linked to the DCP Result Queue is 4 result: message (specifically, 
a GOOD RESULTS (CLASS = 5) Message). The intended destination is the MCS; however, the MCS has 
the option of whether to accept GOOD RESULTS Messages or to have the DCC discard them. | 
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TRANSMIT STATEMENT 


Syntax 


TRANSMIT 


> ADDRESS : ;>| > [-» BREAK 
“ee | 
~ TRANSMIT 


> CHARACTER 


Le BCC 


Le CRC 
| SEQUENCE 


> TEXT 


Exampies 


TRANSMIT. 

TRANSMIT CHARACTER [BREAK:NULL] . 
TRANSMIT SOH STX 400” [BREAK:10]. 
TRANSMIT TRAN. 

TRANSMIT ADDRESS(TRANSMIT)[BREAK]. 
TRANSMIT TEXT|BREAK]. _— 
TRANSMIT “LITERAL STRING”. 


Semantics 


The (transmit statement) causes the adapter cluster to transmit information to:a terminal. The following | 
group of syntax options specifics the information to be transmitted. All options, except CHARACTER, use 
the (byte variable) CHARACTER as a temporary storage area; thus, any information contained in 7 
CHARACTER before execution of the (transmit statement) shall be destroyed by the (transmit statement). 
If none of the first group of options are chosen, it is semantically equivalent to specifying CHARACTER 
(i.c., TRANSMIT is equivalent to TRANSMIT CHARACTER). | 7 | | 


ADDRESS 


The proper number of characters (as specified by the station’s Crerminal definition) in the terminal 
address size statement) ) are taken from the Address field in the Station Table and transmitted. 


ADDRESS(RECEIVE) — | 


This option is equivalent to ADDRESS, except that ADDRESS(RECEIVE) must be used when an address ee 
pair is defined in the (station address statement) and the programmer wants to transmit the receive address. 
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ADDRESS(TRANSMIT) | . fet 
This option is equivalent to ADDRESS, except that ADDRESS(TRANSMIT) must be used when an 


address pair is defined in the (station address statement) and the programmer wants the transmit address : 
transmitted. | (oe 2 *h | 
BCC 

Tlie BCC option causes the content of the (byte variable) BCC to be transmitted. 

CHARACTER _ * , . 

The CHARACTER option causes the content of the Cb yte variable) CHARACTER to be transmitted, 
CRC | | 


This option causes two bytes to be transmitted; CRC[0] is transmitted first, followed by CRC [1 | _ if the 
station's (terminal definition) does not define horizontal parity as CRC(16), the use of this option causes 
a syntax error to be gencrated at compile time. | 


SEQUENCE 


This option causes the character representation of the value stored in the Sequence field of the Station. 
Table to be transmitted if the station is in sequence mode (i.e., the (bit variable) SEQUENCE is TRUE): 
otherwise, the (rransmit statement) is a no-op. ; 4 .. 


TEXT 


This option extracts characters, one at a time, from the associated message, using CHARACTER as a - 
temporary storage area, and transmits the characters until the end of the text buffer is encountered. At that 
point, control branches to the next statement. The TRANSMIT TEXT construct is, in effect, the same as 
the following loop: oo OO | 7 | 


1: FETCH |ENDOFBUFFER:2]. 
TRANSMIT CHARACTER. 
GO TO 1. 


This option can only be used with the Ctransmit statement) in Transmit Requests. 
TRAN 


The proper number of transmission number characters (as defined by the station's (terminal definition) 


in the (terminal transmission number length statement) are extracted from the Transmit Transmission 
Number field in the Station Table and then transmitted. _ = , 8 2 


(string) | Ni - : 7 
Fach character of (string) , using CHARACTER as a temporary storage area, is transmitted... | 
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Transmit Statemerit — Continued | | | oe eaee a 


The BREAK option allows the programmer to specify action if.a “break” is received from the terminal | 
while the adapter cluster is still transmitting. If this option is omitted and a break occurs, an implicit | i oe 
TERMINATE ERROR instruction is executed. The following describes the actions of the three syntactical: Ys 


forms: | 
BREAK | sets TRUE the (bit ied BREAK| TRANSMIT] and causes a branch o of 
control to the next statement. — 
BREAK: (label) sets TRUE the My variable) PRE) and causes a branch of 
control to (label ee ee. 
BREAK:NULL. causes no action. Execution proceeds as if the break did not sete 
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WAIT STATEMENT 
Syntax 


ae siawicbenied 
(——_» <wait time) 


Examples 


WAIT. | 
WAIT (3 SEC). 
WAIT (5 MILLI:6). 


Semantics 


The (wait statement) is only allowed in (request definition)s that are written to communicate with full 
duplex terminal types. Execution of this statement causes the (request definition) to be suspended until 
the co-line executes a (continue statement). The optional syntax effects the statement as described below. — 


(wait time) defines the maximum amount of time) that the (request definition) should 
be suspending waiting for the (continue statemen ty. If (wait time) is 
exceeded and the co-line has not executed a (con tinue statement) execution 


_—, ; resumes at the next sequential statement. 
eee” . : . : ae : : oe 
(wait time’ label) same as above except execution resumes at label) if a (continue 
statement) is not executed within (wait time). 


Pragmatics 


Refer to the (fork statement ) pragmatics. 
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ST ATION DEFINITION 
Syntax 


STATION lL... (station identifier \ 
DEFAULT _» (default station identifier) 


Examples — 

STATION KMET: 
ENABLEINPUT = FALSE. 
MCS = SYSTEM/CANDE. 
CONTROL = 4“6F”. 
RETRY = 15. | 
LOGICALACK = FALSE. _ | 
MYUSE = INPUT, OUTPUT. 
TERMINAL = TELETYPE. 

STATION DEFAULT STADFLT2: 
CONTROL as dae os 
MCS = SYSTEM/CANDE. 
ADAPTER =4 | | 

= STADFLT1. 


DEFAULT | 
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: he (station adapter statement) 
p- (station address statement) . 
(station control character statement) > 
> (station default statement ) 
p (station enableinput statement) 
- (station frequency statement) 
| (station initialize statement ) 
Lee (station logicalack statement) 
p> (station MCS statement ) 
be (station modem statement ) 
- (station myuse statement ) 
(station nae statement ) | 


e (slutian phone statement ) 


(station retry StALCINCHE ) meee 


(station terminal type statement ) 


p- (station width statement ) — 


. Definitions. . - : “ 
“STATION 


Continued ie 


Semantics 


(station identifier) and (default station identifier) have the syntactical form of a (system identifier). af 
Each syntactical form of the (station definition) is described subsequently. a ee 


STATION (station identifier): ... 


This form of the (station definition) defines the attributes of a station. The attributes must be-defined in 
one of the following ways: _ | te Ss 


4. Each attribute is explicitly defined by means of a (station statement). 


b. Each attribute is defined implicitly by means of an explicit reference to a set of previously : : 
defined default attribute valucs. | | | o aakak = 


c. Some of the attributes are defined implicitly as in b, and the remainder are defined explicitly as 
iN a. | | . Se 


Some of the station attributes must be defined for each station; others do not. Some of the statements | 
may or may not be required, depending upon the appearance of other statements. The semantics portion — 
of cach (station statement) states, among other things, whether the attribute must be defined and its 
effect upon the requirements of other (station statement)s. — 7 | | 58 


To define the attributes of a station as described in item a above, only this syntax form is used. ; 


To define the attributes of a station as described in items b and c above, this syntax form, thé following 
syntax form, and the (station default statement) must be used in conjunction (this is described under the 
following syntax form). | a co ee a | 


STATION DEFAULT (default station identifier): ... 


This form is referred to as a Default (station identifier). Its purpose is to decrease the number of source’ 
statements required to define all of the stations. This is accomplished ‘in the following manner. Attributes 
common to several stations are defined by means of a Default (station definition). Associated with each _ 
Default (station definition) is a (default station identifier). Subsequent to the Default (station | 
definition, any Cstation definition) can reference the (default station identifier), instead of repeating © 
the list. A (default station identifier) is reterenced by means of a (station default statement). The NDL 
compiler uses the last definition of a station attribute, and therefore the programmer can reference a _ 
Default (station definition) and change any attributes by redefining them in the (station definition). — 


In appearance, the Default (station definition) is similar to the (station definition) . The differences are 
that the reserved word DEFAULT follows the reserved word STATION, and that there are no statements 
that are required to appear in a Default (station definition). - , | -—_—a 
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STATION ADAPTER STATEMENT 


Syntax 

ADAPTER aa ena type number ) ie = er ars — * 
(= (communication type number)-»> (communication type number)->) - o 

Examples 


ADAPTER = 4. 
ADAPTER = (11,6). 


Senranties 


The (station adapter statement) defines a combination of character format, synchronous/asynchronous 
communication, and line speed (in the case of synchronous communications) that the DCP must use to 
communicate with the terminal associated with the station. This is done by supplying a (communication | 
nepe number) (or number pair). Table 5-4 lists the allowed (ommmunication type number)s and the 
characteristics associated with each. 7 3 | ge 


For example, 


ADAPTER = 4. 


This statement defines an 11-bit character format, asynchronous communication, at a line speed of 110 bits. | 
per second. | | 2 88 


If the station’s associated terminal type utilizes full duplex (i.e., the (terminal duplex statement) specifies 
)UPLEX=TRUE), and the primary and the auxiliary lines have different characteristics, thena = 
communication Ivpe number) pair must be supplied. . < F | | 


For example, 
ADAPTER = (11.6). 


This statement defines for the primary line a 10-bit character format, asynchronous communication, ata 
speed of 1800 bits per second. The characteristics associated with the auxiliary line are the same except 
that it runs at a linc speed of 150 bits per second. | | - 


The statement: | 
ADAPTER = (6,6). 

is semantically equivalent to: 
ADAPTER = 6. © 


The Ccommunication type number) (or number pair) defined in this statement must be one of those 

listed in the Germinal adapter statemen t) of the station’s associated (terminal definition). The (station _ 
adapter statement) is required unless the {terminal adapter statement) lists only one (communication type 
number) (or number pair), in which case, the (station adapter statemen t) may be omitted and the 
‘terminal adapter statement) specification is used. | | oe 


5-136 


Definitions. — 
- STATION — aa 
“Station Adapter Statement — = Continued i. 


Supplementary Examples | 
The following program fragments illustrate vane adapter statement specifications. 
Example | 
MODEM AMODEM: 
ADAPTER=1 2.345.6,78910. 


TERMINAL ATERMINAL: 
ADAPTER=6,7,8,9,11,12,13,14,15. 


STATION ASTATION: 


ADAPTER=7. _ 
MODEM=AMODEM. 
TERMINAL=ATERMINAL. | 


Example 2 
MODEM DUPLEXMODEM: 
ADAPTER=6, (11,6), (12,6), 12. 


"TERMINAL DUPLEXTERMINAL: 
“ADAPTER=6, (11,6). 


STATION DUPLEXSTATION: 


ADAPTER=(11,6). 
MODEM=DUPLEXMODEM. 
TERMIN acai 
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STATION ADDRESS STATEMENT 
- Syntax = | 


— ———______— , 
Le (te string) ——oe 1 —m> (stringy >) 
Examples : 
ADDRESS = 401". 
ADDRESS = (40001 ”, ” 401 ey 
ADDRESS = “A”, 
Semantics — 


The é tation address statement) defines the actual address characters.of the station’s terminal that are 
required for operations such as polling and selecting. The number of characters in the (string) (s) must be 
equal to the number defined-in the (terminal address size statement) of the associated terminal. This — 
statement is not allowed in Default (station defi nitions). 


ADDRESS = (string). 


This form of the statement is used when the receive address and the transmit address are the same. 


ADDRESS = ( (string) , (string) ). a a re ee 8 | | , as 4 : Ae 
This form of the statement must be used if the receive sddee and the transmit address differ. The first ! : 


(string) defines the receive address characters, and the second Sins): defines the transmit address : 
characters. - | 


Pragmatics — 


The address characters of a station can be changed: as a result of the edn Control sa acs) | i 
executing a SET aes ek 39) DCWRITE.. | | | 
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STATION CONTROL CHARACTER STATEMENT 
Syntax a 


CONTROL ———> = +» (single CWiarae hep aaa 


Example | 

CONTROL = “?”,. 
Semantics | | a 
The (station control character statement) defines the control character of the station. The control ; 
character can be recognized by the DCP when RECEIVEd in a message text from the station, and any 


action to be taken can be specified by the programmer using the CONTROL syntax in the receive 
statement). | we a eS : 
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STATION DEFAULT STATEMENT 
Syntax | 


DEFAULT ———» = ————_- (de fault station. identifier )_--———_______________» - 


Example | 
DEFAULT = STADFLTI. 
Semantics 


The (station default statemen t) allows the programmer to specify the (default station iden tifier) of a set’ 
of previously defined default station attributes to be used for a (station definition) whose description is _ 
incomplete. It is advantagcous to group common attributes under a Default (station definition) and list 
the remaining attributes under each individual (station definition). The compiler will then refer to the — 
Default (station definition) to complete the (station definition). The (tation default statement) is not 
required to appear in cach (station definition) ; however, a (station definition) must define all required 
attributes locally if a ¢ tation default statement) does not appear. — es | a 


The (station default statement) can appear in a (station definition) or a Default (station definition). — 
Supplementary Example : i : | 


The following is an example of how a Default (station definition) can-be used in conjunction with a 
(station definition), et Ps ae , | | 


STATION DEFAULT STADELT: 


MCS = SYSTEM/CANDE. 

CONTROL == “2”, a | 
RETRY = 15. PU oe, ie ee 
LOGICALACK = FALSE. | 7 | Default (station definition)} 
MYUSE = INPUT, OUTPUT. | | . * a | 
TERMINAL = = TELETYPE. | 
ENABLEINPUT = TRUE. 

SPATION TESTSTATION: : (station default statement ) references 
DEFAULT = STADFLT. “—————— > Default ( station definition) above to 
MODEM = MABELLI03<A. _— complete the (station definition). 
MCS = SYSTEM/DIAGNOTICMCS. | Se | 
ADAPTER = 4. | 


5—140 


5 rn ) Definitions . pea 
Station Fnableinput Statemen 


STATION ENABLEINPUT STATEMENT 


‘Syntax — | 
ENABLEINPUT ——e : 

oe ———— FALSE 
Semantics 


The (station enableinput Statement) defines the initial state of the station’s “enabled” bit (program- 
matically referred to as STATION(ENABLED)). This statement must be defined in each (station 
definition). | | | | | oe gO Se 
ENABLEINPUT = TRUE. 


This construct causes the “enabled” bit to be initially TRUE after DCP initialization, and the station is — | 


said to be “enabled for input,” or simply “enabled.” 
-ENABLEINPUT = FALSE. 


This construct causes the “enabled” bit to be initially FALSE after. DCP initialization, and ‘the station is 
said to be “disabled for input,” or “‘disabled.” . _ 2s * | EG a cS 


* 


Pragmatics 


Whether a station is chabled or disabled for input can directly affect the execution sequence of instructions 
in the (control definition) and request definition’ (s) designated for that station. Specifically, if the 

_ Station is disabled for input, contro! will never branch to the Receive Request for that station as a result 

of cither an INITIATE ENABLEINPUT or a TERMINATE ENABLEINPUT construct. Refer to the 


INITIATE ENABLEINPUT and TERMINATE ENABLEINPUT constructs for more detailed information. 
The MCS of the station may change the state of the “enabled” bit, after DCP initialization, by means of the 
ENABLE INPUT (TYPE = 35) DCWRITE or the DISABLE INPUT (TYPE. = 36) DCWRITE. 
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STATION FREQUENCY STATEMENT 
Syntax | 


FREQUENCY ———-= (inte) $$. : 


i:xample 
FREQUENCY = 10. 


Semantics 


The Qlation frequency statement) defines the initial value of the (byte variable) programmatically 
referred to as STATION (FREQUENCY). The (control definition) specified for the station can reference 
the (byte variable) and use the value stored there in any way that the programmer sees fit; however, the | 
intended use of the variable is to influence in some way the rate at which a polled station is polled. In the 
polling @ontrol definition) provided by Burroughs Corporation in SYMBOL/SOURCENDL, | 
FREQUENCY spccifies a relative polling rate: 0 means poll at the highest rate, 1 means to poll at a slower 
fate, 2 means to poll at a still lower rate, etc. 


The Cinteger) must not exceed a value of 255. 


The MCS of the defined station can change the value of STATION( FREQUENCY) by means of an ENABLE ~ 
INPUT (TYPE = 35) DCWRITE. | | | + 
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STATION INITIALIZE STATEMENT 

Syntax 

INITIALIZE-47=TOG [ —m(toggle number) —e ] 
on | 
TALLY -> [ -»<(ally number)» | —>[ > (bit number) >] 
TOGS To nteger) 
TALLY >I +> (tally number] (single character) 

Examples 


INITIALIZE TOGS = 4“FF”. 

INITIALIZE TOG|0| = TRUE, 
TALLY|[1] = 25, 
TALLY[0| [7] = TRUE. 

INITIALIZE TALLY[0] = “?”’. | 


Semantics 


The station initialize een provides the means to define initial values for the station TOGG LEs and 
TALLYs. Any initial values defined for station TOGGLEs and TALLYs are stored i in the TOGGLEs and 
TALLYs at DCP initialization time only. | 
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SPATION LOGICALACK STATEMENTE 
Syntax 


| , FALSE ————— | | | 
Semantics 


The (station logicalack statement) defines the initial state of a bit, referred to as the Logicalack bit, in the 
Station Table. TRUE or FALSE can be specified, indicating the initial state.as on or off, respectively. If the 
LOGICALACK bit is on, special action is taken if the Receive Request executes either the TERMINATE | 
LOGICALACK or TERMINATE LOGICALACK(RETURN) constructs of the (terminate statement). — 


This statement is required in (station definition) s. 


The MCS of the station can change the valuc of the Logicalack bit after DCP initialization by means of the 
SET/RESET LOGICALACK (TYPE = 43) DCWRITE. : . 4 
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STATION MCS STATEMENT 
Syntax 


MCS $$$ = (CS identifier) $$$ $$». 


Examples 
MCS = SYSTEM/RJE. 
MCS = SYSTEM/APL. 
MCS = UTILITY/MCS. 
Semantics 


The (station MCS statemen f) defines the Message Control System (MCS) that is responsible for handling 
messages to and from the station. If the MCS named is not an MCS defined in a (MCS definition) , it is 
added to the list of valid MCS programs to be contained in the Network Information File, and the MCS will 
not be allowed to execute diagnostic DCWRITEs. Refer to the semantics of the (MCS definition) for 
information regarding the diagnostic DCWRITEs. This statement is required in (station definition)s. 
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STATION MODEM STATEMENT 
Syntax 


MODEM ——————¥- > (modem identi fier) 


Example 
MODEM = BELL20I. 
Semantics 


The (stution modem statement) applics to a station that has associated with if a terminal type that must 
communicate with the Data Communications System through the use ofa modem. This statement . 
associates the modem type (i-e., a Cnoden definition) ) uscd for that purpose with the station. If this 
statement is omitted from the (station definition) , and the Cline definition) tor the line to which the 
station is assigned (if, in fact, the station is assigned to a linc) docs not contain a (line modem Statement), 
then the compiler assumes a direct connection between the terminal and the linc adapter. | 


The Zinodem identifier must name a {modem definition) that is compatible with the defined station 
attributes. To be more specific, the (communication type number) specified in the (station adapter 
statement) (or in the Clerminal adapter statement) of the station’s terminal definition) if no (station 
adapter oe appears) must be one of the (communication type number) s listed in the (modem 
adapter statementy of the modem named. oe 


After DCP initialization, the MCS of the station may change the Gnodem definition) associated with the 
station. by means of the MOVE/ADD/SUBTRACT STATION (TYPE = 130) DCWRITE. 
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Ria tage. 
. od 


= L  * STATION MYUSE STATEMENT ae ; 
Syntax | | - 2 
MYUSE ——> = INPUT . , ie eee eer a 
OUTPUT ——— 
INPUT ————_—__ » ———_» OUTPUT 
OUTPUT > » > INPUT 


Semantics 


The (station myuse statement) defines to what extent an object job can use the station as in input 
or output device. | : 7 | te. a 


MYUSE=INPUT specifies that an object job can use the station as an input file only. 
MYUSE=OUTPUT specifies that an object can use the station as an output file only. 


MY USE=INPUT,OUTPUT or MYUSE=OUTPUT.INPUT specifies that an object job can use the station as 
an input and/or output file. . : . | 


A Cterminal request statemeni) must be defined by the station’s (rerminal definition) for handling input 
and/or output capabilities as specified in the (station myuse statement!) . Thus, if the station is to send 
input to, and receive output from, an object job, the station’s (terminal definition) must specify a Transmit 
Request and a Receive Request. — | | . ) | 


Note that the (station mVUSC statement) restricts the use of the station by object jobs only. The MCS 
can communicate with the station to the extent specified in the (erminal request statement) of the 
station’s germinal definition) . That is, regardless of what is specified in the (station myuse statement) , 
the MCS can receive information from, or send information to, a station, provided that the station’s 


(terminal definition) specified a Receive and Transmit Request. 


The station MYUSE attribute can be interrogated by an object job through reference to the MYUSE | 
file attribute. For further information, refer to the B 6700 Input/Output Subsystem Information Manual, 
form number S000185. ee = | | 
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STATION PAGE STATEMENT 
Syntax | | 


PAGE ——————— = oN integer) eee 


Examples 
PAGE = 12. 
PAGE = 0. 
Semantics 


The (station page statement) defines the number of logical lines per logical page. The (integer) specified 
must be less than or equal to the number of lines specified in the (terminal page statement) of the 
station's terminal definition (unless that number is zero, indicating pagination is arbitrary). Ifa 
(station page statement) is not included in the <station definition) , the station’s (terminal definition 
specifications for pagination are used. | | 


An object job may obtain the PAGE value of a station, if the station is attached to a file, and that file 
is open, by interrogating the PAGESIZE file attribute and supplying the File Relative Station Number 
(FRSN). Refer to the PAGESIZE attribute in the B 6700 Input/Output Subsystem Information Manual, 
form number 5000185, for more information. — - _ | af . ? 


5--148 


Station Phone Statement : 


STATION PHONE STATEMENT | 
Syntax 


PHONE —————__ = ——________» integer) ———_________ gs. 


Example 
PHONE = 12136572385. 
Semantics 


The (station phone statement) is implemented for documentation purposes only. This statement : | 
documents the telephone number that the system would have to dial to reach the station’s terminal, 
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STATION RETRY STATEMENT 


Syntax 


RETRY —_—_— = eee ge ( integer ) ' | , | =. a 
Example 

RETRY = 3. 
Semantics 


The (station retry statement) defines a default value for DCP 


INITIAL RETRY. Refer to the RETRY 
(pvee variable) for more information. — | a | : 
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i STATION TERMINAL TYPE STATEMENT 
Syntax : e 


TERMINAL ———» = —$______—» (terminal Ghee £49 erin , 


Examples 


TERMINAL = APLTERM. 
TERMINAL = TTY. 


Semantics 


The «station terminal type statement) associates a terminal type with the station. ‘This statement i is 
required in a (station definition) . 


After DCP initialization, the MCS of the station can change the terminal: type decodes with fies station | 
by means of the MOVE/ADD/SUBTRACT sreauer (TYPE = 130) DCWRITE. 
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STATION WIDTH STATEMENT 
Syntax | 


Examples 


WIDTH = 72. 
WIDTH = 132. 


Semantics 


The (station width statement) defines the number of characters in a logical display line of output on the | 
station’s terminal. If this statement is not included in a (station definition) , then the WIDTH defined 
for the station’s (terminal definition) is the default station WIDTH.. | 


An object job can interrogate a station’s WIDTH by testing the value of the WIDTH file attribute. Refer 
to the B 6700 Input/Output Subsystem Information Manual, form number §000185, for further 
information. | eis 
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TERMINAL DEFINITION 
Syntax | 


‘TERMINAL (terminal identifier) , : Lem Crerminal adapter statement) ———— fo] 
 ccmuiadiae (default terminal en, ~o (terminal address size statement) ol 
| | | » terminal buffer size statement’ — ae ; 
(terminal backspace character statement) 
: (terminal carriage character statemen t) 
(terminal clear character statement\— 
_ (rerminal code ‘aaeies statement) 
> <terminal nivel statement) 
: (terminal default statement) . 
(terminal duplex statement) 
terminal end character statement) 
' | = | “= terminal home character statement 
(terminal illegal character statement) 
| (terminal inhibitsyne statement) — 
<rerminal ‘inter-character delay statement) 
(terminal linedelete character statement) 
_ (terminal linefeed character Statement ) 
) -Crdqminal maxinput statement) 
, (terminal page statenien t) 
| (terminal parity statemerit) 
= (terminal request statement) 
(terminal screen Statement) 
(terminal timeout statement) : 
(terminal ‘transmission number length statement) — 
(terminal turnaround statement) 
(terminal width statement). , 


(terminal wru character statement) : 
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Examples 


TERMINAL TTY: 
CODE = ASC67 
PARITY = NULL. 
SCREEN = FALSE 
BUFFER = NULL 
DUPLEX = FALSE 
ADDRESS = NULL 
WIDTH = 72. 
MAXINPUT = 72.. 
TIMEOUT = 300 SEC. os 
REQUEST = RECEIVE: READTTY, 
TRANSMIT: WRITETTY. 
CONTROL = .CONTENTIONDEVICE. 
TERMINAL DEFAULT DEFAULTLISTI1: 
CODE = ASC67. 
PARITY = NULL. 
SCREEN = FALSE. 
BUFFER = NULL. 
Semantics 


(terminal identifier) and (default terminal identifier) each have the syntactic form of (identifier) 


Each construct of the (terminal definition) is described subsequently. 
TERMINAL (terminal identifier) :... 


This form of the. (terminal definition) syntax lefines the attributes of a terminal type in the data ° 
communications network. Most terminal attributes are hardware-dependent. The attributes of the 
terminal type are defined in onc of the tollowing ways: | 


a. Each attribute is defined cxplicitly by means of a (terminal attribute statement) in the 
(terminal definition . | | : | 


b. Each attribute is defined implicitly by an explicit reference to a set of previously defined | 
default attribute values. . , 


c. Some of the attributes are defined implicitly as in b, and the remainder are defined explicitly 
as in a. 43 | : | 


Some of the <ferminal statement)s must be defined for each (terminal definition’ , others do not. 

Some of the statements may or may not be required, depending upon the appearance of other state- 
ments. The semantics portion of each (terminal attribute statement) states, among other things, © 
whether the attribute must be defined and its effect upon the requirement of other attribute definitions. 


To define the attributes of a TERMINAL as described in item a above, this syntax form must be used. 


To define the attributes of a terminal type as described in items b and c above, this syntax form, the 
following syntax form, and the <terminal default statement) must be used in conjunction (this is described 
under the following syntax form). _ ~*~ | a 
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TERMINAL DEFAULT (default terminal identifier) a eet 
This form is referred to as a Default Germinal definition). | . 3 ; a ; 


Its purpose is to decrease the number of source statements required to define all of the terminal types in 
the data communications system. This is accomplished in the following manner. Attributes common to 
several terminal types are defined by means of a Default (terminal definition) . Associated with each 
Default (terminal definition) ‘is a (default terminal identifier). Subsequent to the Default (terminal 
definition) , any . definition) that has those attributes in common may reference the default 
terminal identifier) , instead of repeating the list. (A (default terminal identifier) is referenced by means 
of a <terminal default statement) .) The NDL compiler uses the last definition of a terminal attribute, and 
therefore the programmer can reference a Default Germinal definition) and change any attributes by 
redefining them in the (terminal definition). | 


In appearance, the Default (terminal definition) is similar to the (terminal definition). The differences 
are that the reserved word DEFAULT follows the reserved word TERMINAL, and that.no statements are 
required to appear in a Default terminal definition >. | 
Supplementary Example 


Below is an example of how a Default (terminal definition) can be used in conjunction with a 
(terminal definition) . | | 


| _( DEFAULTLIST1 is the default 
_ : i | ( terminal identifier) of this Default — 
TERMINAL DEFAULT DEFAULTLIST!I: | : <terminal definition). The set of default 

— ae | : | attributes that follows is referenced by 
CODE = ASC67. | ae 
PARITY = NULL. { a ( terminal statement)s define the default 
SCREEN = FALSE. | attributes associated with DEFAULTLIST 1. 
BUFFER = NULL. 


Above, DEFAULTLIST] has associated with it four attributes. Any subsequent (terminal definition) 
in a source program can reference these default attributes by the appearance of a (terminal default _ 
statement) in the (terminal definition). The (terminal default statement) has the form: 


DEFAULT = (default terminal identifier) ——  - 


where the (default terminal identifier) must name a previously defined Default (terminal definition). 
More information regarding the use of Default (terminal definition) s in conjunction with (terminal 
default statement)s can be found in the (terminal default statement) semantics. | | 


Below, TTY uses the (terminal default statement) to reference DEFAULTLIST1. DEFAULTLISTI 
contains the attribute information required to complete the (terminal definition) TTY. ee 


TERMINAL TTY: | e a | 
| | This ¢ terminal default statement) 
DEFAULT = DEFAULTLIST1.<——— references the Default (terminal — 
DUPLEX = FALSE. definition) defined previously. 
ADDRESS = NULL | | 
WIDTH = 72. 
2 MAXINPUT = 72. 
i | TIMEOUT = 300 SEC. oe | 
CONTROL = CONTENTIONDEVICE. — 7 an 
REQUEST = RECEIVE: READTTY, TRANSMIT: WRITETTY. 
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Terminal Adapter Statement 


TERMINAL ADAPTER STATEMENT 
Syntax 


ADAPTER —&= Ccommunication type number 


(> (communication tripe number )—= 5 —B( communication type number y=) 
Examples 


ADAPTER = 4. 
ADAPTER = (6,10), (10,6). 
ADAPTER = 5, (5,6), 6. 


Semantics 


The oe adapter statement) defines one or more combinations of character format, synchronous/ 
asynchronous communication, and line speed (in the case of asynchronous communications), with which 
the terminal type is compatiole. This is done by supplying one or more (communication type number) s 
(or number pairs). Table 5.4 lists the allowed (communication type number) s and the characteristics 
associated with cach. 


If the terminal type is to be operated in a full duplex mode, and the primary and the auxiliary lines have 
different characteristics, then a (communication type number) pair must be supplied. — 


if the terminal is to be modem-connected (i.e., connected to the system through the use of modems), 
then at least one of the «communication type number) s (or number pairs) must be compatible with those 
numbers listed for the connecting modem in the Qnodem adapter statement). 
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Terminai Acdress Size Statement 


TERMINAL ADDRESS SIZE STATEMENT 
Syntax | 


ADDRESS —>= Cua NULL 
(receive address size) + - ' ; 
l> (DIFFERENT) — 


Lm» —e (transmit address size) = 


Examples 


ADDRESS = 2. | 
ADDRESS = 2 (DIFFERENT). 
ADDRESS = 3, 2 (DIFFERENT). 
ADDRESS =2,3. | 


Semantics 


The (terminal address size statement) defines the number of address characters that the terminal type 
transmits and receives. The number of address characters must not be confused with the actual address 
characters used in polling and selecting; the (station address statement) defines the actual address char- 
acters, This attribute must be defined when actual address characters are defined in the (station 
address statement) of a (station definition) that references the (terminal definition). Bnet 


‘ receive address size) and (transmit address ie) must be integers greater than zero and less than 4. _ 
The (receive address size) defines the number o ‘address characters the terminal expects to receive, and 
the (transmit address size) defines the number of address characters that the terminal transmits. If the 
transmit address size) is not defined, it is assumed the (transmit address size) is equal in length to the 
receive address size). The (receive address size) and the (transmit address size) for a given terminal _ 
must concur with the length of the character (string) (s) defined as the actual address characters in the 
(station address statement) of any (station definition) which references the (terminal definition) , 
otherwise, a syntax error results. | 


The (DIFFERENT) option must be used if the (receive address) and the <transmit address) _as defined 
in the (station address statement) , are not identical. nr a 
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Terminal Backspace Character Statement 


TERMINAL BACKSPACE CHARACTER STATEMENT 
Syntax 


BACKSPACE ——————> = —_—_—-»( single character ) eae 


_ > (DYNAMIC) - 
Examples a 
BACKSPACE = 4°16”. | | | ~ — 
BACKSPACE = “*” (DYNAMIC). : cad 
Semantics ° 
The (terminal backspace character statement) defines the backspace character of the termina! type 
(.e., the character that the terminal type would transmit to indicate that the previous character should 
be deleted). If defined, the backspace character can be recognized by the DCP when RECEIVEd (if’a 
{ receive statement) ), and any action to be taken can be specified by the programmer (using the . 
BACKSPACE syntax). “na —_ | | - 
(DYNAMIC) indicates that the controlling MCS ofa station referencing the (terminal definition) is 
allowed to change the backspace character for the station by means of a SET CHARACTERS (TYPE=39} 
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; | | Terminal Buffer Size Statement 


TERMINAL BUFFER SIZE STATEMENT 
Syntax 


( integer Y 


Examples 


BUFFER = NULL. 
BUFFER = 960. 


Semantics 


The (terminal buffer size statement) applies to buffered devices and defines the size, in characters, — 
of the terminal type buffer. If the terminal type is an unbuffered device, the form: Oo 


BUFFER = NULL. 


can be used, or the statement may be omitted; additionally, if the device is unbuffered, the terminal 
maxinput statement) must be defined for the ‘terminal definition) . 
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‘Terminal Carriage Character Statement 


TERMINAL CARRIAGE CHARACTER STATEMENT 
Syntax 


CARRIAGE ——— = an (single character ) Lee 


Example 
CARRIAGE = 4“0D”. 
Semantics | 


This statement is implemented for program documentation purposes only. This statement provides a 
means of documenting the carriage return character of a terminal type. The documentation of this 
character is optional in a (terminal definition). | 


5-- 160 


Definitions’ . = 
TERMINAL 


Terminal Clear Character Statement 


TERMINAL CLEAR CHARACTER STATEMENT 
Syntax 


CLEAR ————-> = ———— ( single character ) a . 


Example 
CLEAR = 4“11”. 
Semantics 


This statement is implemented for program documentation purposes only. It provides a means to 
document the clear character of a terminal type. The documentation of this character is optional in a 
(terminal definition). | 3 7 
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Terminal Code Statement 


TERMINAL CODE STATEMENT 


Syntax 


CODE ——- = > ASCII (BINARY) — 


= ASC67 — 

ASC68 

> BAUDOT 

> BCD 

> BCL 

-» BINARY aoe 
> EBCDIC 


= PTTC6l 
Semantics 


The Germinal code statementy specifies the character code translation required for the DCP to — 
communicate with the terminal type. The internal code of the DCP is EBCDIC, and the DCP translates a? 
from EBCDIC to the code specified for transmissions, and from the code specified to EBCDIC for 
receptions. 


BINARY and EBCDIC specify that translation ts not required. 
ASC67 and ASC68 specify the standard software translation tables for the ASCII character code. 


ASCII (BINARY ) allows a control definition) or (request definition) to switch back and forth between 
ASCII code translation and no translation. The ode statement) ina (request definition) or 

control definition) effects the switch back and forth. The application of this feature is to allow a 
crequest aaa or control definition) to enter a “transparent” mode in Binary Synchronous 
communications procedures. 


BAUDOT, BCD, BCL, and PTTC6I specifications are all indicative of the translation they invoke. For 
example, BAUDOT invokes the Baudot character code set, PITC6l invokes PTTC/6, etc. | 


- Pragmatics 
For special applications a programmer can define and invoke non-standard character codes by: - 
4. defining a translation table ina (translatetable definition) ; 
b. specifying BINARY or EBCDIC in the (terminal code statement) > and 


c. invoking the translation ina <control definition) or (request definition) by means of the | 
appropriate option of the (assignment statement). 


Refer to the <translatetable definition) in this chapter for more information. 
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Terminai Control Statement 


TERMINAL CONTROL STATEMENT 
Syntax 


CONTROL —®> = —® (control identifier) 
| | > —e (control identifier ) 


Examples 


CONTROL = CONTENTION. 
CONTROL = PRIMARYCONTROL, 
AUXILIARYCONTROL. 


Semantics 


The (terminal control statement) specifics the (control definition) (s) responsible for allocation of the 
logical line(s) to which a terminal type is associated. This attribute must be defined for all (terminal 
definitions). : | 


Terminal typcs that do not utilize full duplex, reverse channel, or voice response features require that only 
one (control identifier) be named. 


Terminal types that utilize full duplex, reverse channel, or voice response features (i.e., DUPLEX = TRUE) 
may optionally specify a second (control identifier). The first (control identifier) names the (control 
definition) for the primary line, and the second ‘control identifier) names the <control definition) for 
the auxiliary line. If only one (control identifier is specified, it is assumed to be the (control definition) 


for the primary linc, and the default equivalent of an (idle statement) is used for auxiliary line control. 
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Terminal Default Statement 


TERMINAL DEFAULT STATEMENT 


Svntax 


DEFAULT ———_——> = ——— (default terminal identifier ) -———_— > * 


Ixample 
DEFAULT = TTYDFLT. 
Semantics 


The (ferminal default statement) allows the programmer to specify the (default terminal identifier) 
of a set of default terminal attributes previously defined to be used for a <terminal definition) 
whose description is incomplete. It is advantagcous to group common attributes under a Default 
(terminal definition) and list the remaining attributes under each individual (terminal definition) . 
The compiler will then refer to the Default (terminal definition) to complete the (terminal | 
definition). The (terminal default statement) is not required to appear in (terminal definitions) . 
however, a Germinal definition) must detine all required attributes if a (terminal default statement) 
does not appear. 


The (terminal default statement) can appear ina (terminal definition) or a Default (terminal 
definition) | | | | | 


Supplementary Example 


The following example illustrates how Crerminal default statement)s may be “nested” to combine the 
attributes of one or more Default (ferminal definition)s. | 


The effect of referencing GENERALDEFAULT within the Default (terminal definition) TTYDEFAULT 
‘< that the attributes associated with TTY DEFAULT are equivalent to all attributes as defined by 
GENERALDEFAULT plus the attributes explicitly defined in TTYDEFAULT. 


Ifa (terminal definition) or Default (terminal definition) references a Default (terminal definition), 
the compiler docs not compare the two definitions for contradictory statements. If contradictory state- 
ments exist within the two definitions, the last value defined for the attribute takes precedence. In the 
example, TTY 2 defines the value of the PAGE attribute as 66, and the Default (terminal definition) 
that TTY2 references defines the value of the PAGE attribute as 0. The compiler uses 66 as the value 
of the PAGE attribute for TTY2. | | | 
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Definitions : | . 
_ TERMINAL _ 
Terminal flefautt Statement — Continued - 


PAGE 


TURNAROUND = 0. 
ICTDELAY = 0. | | ~ 
TRANSMISSION = 0. —t——Default ¢termingl definition) 
ADDRESS = 0. | fo 
PAGE = 0. 
BUFFER = 0. 

TERMINAL DEFAULT TTYDEFAULT: , | | Oo : 
DEFAULT = GENERALDEFAULT. | Boheme default statement) references- 
BLOCK = FALSE. above Default (terminal definition Ds. | 
SCREEN | = FALSE. | | . : 
PARITY = NULL. | | - 4 
SYNCS = FALSE. ——I———Pefault terminal definition) © 
TIMEOUT = 3 SEC. f Oy a 
MAXINPUT = 72. 

WIDTH = 72. . 
ADAPTER =4, — 
CODE = ASC67. 

TERMINAL TTY1I: . 27 4 3 

DEFAULT = TTYDEFAULT. | teats default statement) references 
- DUPLEX = FALSE. oe above Default (terminal definition) s.” 

WRU = ENQ. - | - 

END = ETX (DYNAMIC). 

BACKSPACE = BS (DYNAMIC). 

CONTROL = CONTEND. ee | +e eee 

REQUEST = WRITETTY: TRANSMIT, READTTY: RECEIVE. 

TERMINAL TTY2: | | | 
DEFAULT = TTYDEFAULT. 7 | 7 {< terminal default statement) references 
DUPLEX = FALSE. | above Default Germinal definition)s. 
WRU = 4°98". | 
BACKSPACE = 4°97". | 
CONTROL = SPECIALCNTRL. | | | 
REQUEST [1] = READER: RECEIVE, WRITER: TRANSMIT. 

REQUEST [2] = READPPT: RECEIVE,. WRITEPPT: TRANSMIT. — 
= 66. - 
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Terminal Duplex Statement | ; 8 


TERMINAL DUPLEX STATEMENT oe | | | | 
Syntax a | | : | - <_ | : | 7 
DUPLEX ———» = — TRUE ———_—— a — 
Semantics | 7 


The <terminal duplex statement) defines whether or not (TRUE or FALSE, respectively) the terminal 
type utilizes full. duplex, reverse channel, or voice response features. If DUPLEX = TRUE, then the (line 
definition) for any line that has this terminal type assigned must contain the (line type statement) con- | 
structs that specify full duplex. This attribute must be defined for each (terminal definition). 
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Terminal End Character Statement _ 


TERMINAL END CHARACTER STATEMENT 
Syntax 


END ———————_____> = ——¢ single character ) 


(DYNAMIC) 


Examples 


~END = 4“0D”. 
END = “&” (DYNAMIC). 


Semantics 


The (terminal end character ienent defines the ‘ ‘end” character of the terminal type (i.c., the character 
that the terminal type would transmit to indicate an end-of-text). If defined, the “end” character can be 
recognized by the DCP when RECEIVEd (in a (receive statement Di and any action to be taken can be 
specified by the programmer (using the END syntax). 


(DYNAMIC) indicates that the Message Control System of a station referencing the Germinal definition 
is allowed to change the character for the station - means of a SET CHARACTERS (TYPE=39) 
DCWRITE. | 
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Terminal Home Character Statement 


TERMINAL HOME CHARACTER STATEMENT 
Syntax 


HOME ——————_. = ———— (single character ! $$ : 
Example 

HOME = 4“‘0C”’. 
Semantics | 
This statement is implemented for program documentation purposes only. It provides a means of docu- 


menting the home character of the terminal type. The documentation of this character in a (terminal — 
definition) is optional. : | 
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 ~s | ; Terminal {llegai Character Statement i 


TERMINAL ILLEGAL CHARACTER STATEMENT 
Syntax 


[ILLEGALCHR ————- > = —_——__—_>> ( single character) i . 


Example 
{LLEGALCHR = 4“FF”. 
Semantics 


The <terminal illegal character statemen t) is implemented for documentation purposes only. The docu- 
mentation of this character is not required in a terminal definition). oe 
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Terminal Inhibitsync Statement 


TERMINAL INHIBITSYNC STATEMENT 
Syntax 


INHIBITSYNC ———————> = - aoe rn ° 
FALSE | 


Semantics 


The Germinal inhibitsync statement) affects only terminal types that specify any of the Ccommunication 
type number)s 17 through 27 in its (terminal adapter statement). This statement has no affect upon, and 
need not be defined for, terminal types that do not specify any of those (communication type number)s. 


If INHIBITSYNC = FALSE, then the following occurs during a synchronous transmission. The trans- 
mission begins with the transmission of four sync characters by the adapter cluster. As the fourth sync 
character is being transmitted, the first character of the message is requested from the DCP. The DCP 
should respond to this request by supplying the first character of the transmission. As each supplied 
character is transmitted, the adapter cluster requests another character. If the DCP is unable to respond in 
time to the request, the adapter cluster transmits a sync character; this process is called “sync filling.” 
Sync filling is repeated as necessary until the DCP responds with another character or the DCP directs the 
adapter cluster to “finish transmit”’ for the line. | 


When INHIBITSYNC = FALSE during a synchronous reception, the following occurs. At the beginning of 
the reception, bit patterns from the line are examined by the adapter cluster and the bits discarded until a wast 
sync character is recognized. The recognition of a sync character establishes that the next bit to be 
received by the adapter cluster is the first bit of the next character. The sync character is discarded, 
instead of being made available to the DCP. All characters in the transmission that are not sync characters 
are made available to the DCP. The DCP may then fetch these characters.. Any sync characters received in 
the transmission are discarded. . 


if INHIBITSYNC = TRUE , then the following occurs during a synchronous transmission. All actions occur 
that would occur if INHIBITSYNC = FALSE. In addition, if a sync fill is required, a “sync fill interrupt” 
occurs so that the DCP can determine when one or more undesired sync characters have been inserted into 
the transmission. System software responds to the interrupt by executing a TERMINATE ERROR. The 
controlling MCS is notified of all such situations so that corrective action (MAKE LINE READY (TYPE = 
96) DCWRITE, for example) can be taken. a - 


When INHIBITSYNC = TRUE during a synchronous reception, the following occurs. At the beginning of 
the reception, bit patterns from the line are examined by the adapter cluster and the bits discarded until a 
sync character is recognized. The recognized sync character is discarded, as is the next character if it is 
also a sync character. Thereafter, all subsequent characters (sync characters or otherwise) are made avail- 
able to the DCP as data. , | 


The reserved word SYNCS is a synonym for INHIBITSYNC. 
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Terminal Inter-Character Delay Statement 


TERMINAL INTER-CHARACTER DELAY STATEMENT 
Syntax | 


ICTDELAY ————_> = (delay time ee as - ) = — = : | 


Examples 


ICTDELAY = 0. 
ICTDELAY = 200 MILLI. 


Semantics 


The Crerminal inter-character delay statement) provides the user a means to insert a timed delay between 

cach character transmitted to the terminal type. The (delay time) specified defines the.interval of (time) 
between the transmission of the start of one character to the start of the next character. If the time speci- 
fied is less than the timc required to transmit a character, this statement has no effect. This attribute must 
be defined for all (terminal definition) s. : 7 


a 


Supplementary Example 


A Model 33 TELETYPE can receive characters at a maximum rate of one character every 100 milliseconds. If. 
for some reason, the programmer needs to insert a 100-millisecond delay between each character trans- 
mitted to the terminal, this can be done by specifying: | ; a | 


ICTDELAY = 200 MILLI. 
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+ERMINAL LINEDELETE CHARACTER STATEMENT 
Syntax | 
LINEDELETE ——— > —> { single character) 
Examples 

LINEDELETE = 4“07”. 

LINEDELETE = 4“A0”. 
Semantics | 
The Germinal linedelete character statemen t) defines the linedelete character of the terminal type. If. 
defined, the linedelete character can be recognized by the DCP when RECEIVEd (in a (receive statemen ty), 
and any action to be taken can be specified by the programmer (using the LINEDELETE syntax). -_ 
(DYNAMIC) indicates that the Message Control System of a station referencing the (terminal defini tion) 
is allowed to change the character for the station by means of a SET CHARACTERS (TYPE=39) 
DCWRITE. | a | as 
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Terminal Linefeed Character Statement 


TE RMINAL LINEFEED CHARACTER STATEM ENT | 
Syntax 


LINEFEED ————» = ——————»- ( single character) — 


Example 


LINEFEED = 425”. 
Semantics 


This statement is provided for program decitnientibn only.. It fo cuments the linefeed character of the 
terminal type. The documentation of this cnaraclery ina (terminal definition) is optional. 
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Terminal Maxinput Statement 


TERMINAL MAXINPUT STATEMENT 
Syntax ) 


MAXINPUT ————————— = integer ) 
Example 

MAXINPUT = 72. 
Semantics | 
The Germinal maxinput statement) applies to unbuffered terminals and defines the maximum size text, in. 
characters, that a terminal is allowed to transmit in One message. This attribute must be defined in ali. - 
Crerminal definition)s in which the (terminal buffer size statement) is not defined or is defined as 


BUFFER = NULL. This statement applies only to unbuffered devices; it is meaningless to define maxin- 
put if the (terminal buffer size statement ) is defined as non-NULL. s | 
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Terminal Page Statement 


TERMINAL PAGE STATEMENT 
Syntax 


PAGE —————”C*=*™*S ponaveneeniee C tee?) A . 


Examples 
PAGE = 0. 
PAGE = 12. 
Semantics 


The <terminal page statement) defines the maximum number of output lines per page as restricted by the 
hardware of the terminal. There are, for example, devices that can only print/display a defined-number of . 
lines before some type of carriage/cursor control information must be supplied. If the terminal type being 
defined has no such restrictions, then oe a ~ ne 


PAGE = 0. 


should be specified, thus indicating that pagination is arbitrary. This attribute must be defined for all 
(terminal definition)s. | | | | : 
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Terminal Parity Statement 


TERMINAL PARITY STATEMENT | 


Syntax 

PARITY —>= 
jie 
Le ODD 
:—& CRC(16) - 

Examples | | 


PARITY = NULL. | 

PARITY = VERTICAL:ODD. 

PARITY = HORIZONTAL:CRC(16). | 

PARITY = VERTICAL:ODD, HORIZONTAL(0):EVEN. 


Semantics 


Vhe (ferminal parity statemen t) defines the type of parity checking and generation to be performed by the 
DCP when communicating with the terminal type. If the form: —_ . | a 


PARITY=NULL. 
is used, parity is not checked or generated. 


The VERTICAL option refers to the vertical parity bit of a character, and can be defined as ODD or EVEN. 


- The HORIZONTAL option specifies the type of horizontal parity. If horizontal parity is a Block Check 
‘Character, then ODD or EVEN must be specified. If horizontal parity is a Cyclic Redundancy Check, then 


CRC(16) must be specified. 


The 0 or 1 option defines the function of the vertical parity bit of the Block Check Character. If this bit is 


a parity bit for the Block Check Character, then this option must be omitted or defined asO(zero). If 
undefined, the option is assumed to be 0 (zero). If the bit is to be considered as a horizontal parity bit of 
all high-order bits in the message, then this option must be defined as I. 3 
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i Cae | 3 7 Terminal Request Statement. 


TERMINAL REQUEST STATEMENT | 
Syntax | 
REQUEST : = , (request identifier): -@ RECEIVE. 
) [me {Cinteger) value of 1 thru 6} >] l , request identifier): ~©TRANSMIT “ 
Examples 


REQUEST = READTTY:RECEIVE. _ : 
REQUEST = WRITETTY: TRANSMIT, READTTY:RECEIVE. 
-REQUEST[2] = TTYTAPEIN:RECEIVE, TTYTAPEOUT: TRANSMIT. - 


Semantics 


The (terminal request statement) specifies a (request identifier) , or a pait of (request identifier) s, that 
designates the (request definition) to handle input from (the RECEIVE option) and/or output to (the — 
TRANSMIT option) the terminal type. The Crequest definition) that handles input is commonly referred 

to as the Receive Request, and the (request definition) that handles output is commonly referred to as the. . 
Transmit Request. This statement must appear in each <terminal definition) , and cannot appear in a 
Default Germinal definition). mes — io "a oe oe a 


The {¢ integer) value of 1 through 6} allows the specification of up to six pairs of Transmit and Receive 
Requests for the same devicc. Normally, these Request pairs differ for some application-dependent . 
reasons. Only one pair of (request definition)s can be the controlling (request definition) s at.any instant 
of time. The (request definitions in control of the terminal type immediately after DCP initialization 
has an {Cinteger) value of 1 through 6} of 1; they retain control until the Message Control System (MCS) 
of a station associated with the terminal type executes a SET APPLICATION NUMBER (TYPE = 38) 
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Terminal Screen'Statement 
TERMINAL SCREEN STATEMENT = 
Syntax ar 


SCREEN ———__> = — —» TRUE 


——e*FALSE - 
Semantics | 
The (terminal screen statement) defines whet 


her or not (TRUE or FALSE, respectively) the terminal type — 
is a screen (i.c., CRT) device. This attribute must be defined in each (terminal definition). oe 
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| Terminal Timeout Statement 
TERMINAL TIMEOUT STATEMENT | 
Syntax 44 - 


Example <a. «1 | 
TIMEOUT = 3 SEC. _ 

Semantics — | - | , OO fk | | 
The (terminal timeout statement) defines the interval of (time) that the adapter cluster should wait from _ 
the receipt of one character to the start of the next (ina (receive statement) before assuming that the 
terminal has “timed out.” The action taken upon a timeout condition can be specified in a (receive 


statement) by means of the TIMEOUT syntax. : 


si? 
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Terminal Transmission Number Length Statement 


+E RMINAL TRANSMISSION NUMBER LENGTH STATEMENT 
Syntax | 


TRANSMISSION ——— = ~ 


Semantics 


The ¢terminal transmission number length statement) defines the number of characters that the terminal 
transmits and receives as the message transmission number. The 0 and NULL options are semantically 
equivalent and specify that no transmission number is used. A non-NULL transmission number length 
must be specified if a control definition) or (request definition) that references the item TRAN is | 
defined for the terminal type. This statement may be omitted from.a ‘terminal definition) if the terminal 
does not transmit or receive transmission numbers. oe “7 : 


‘ * 
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Terminal Turnaround Statement. 


TERMINAL TURNAROUND STATEMENT 
Syntax 


TURNAROUND ————> = ———¢_ time) ———__________—___—— . 


Examples 
TURNAROUND = 0. _ 
‘TURNAROUND = 200 MILLI. 
Semantics | 


The <terminal turnaround statemen t) defines the time required for the terminal to shift from transmitting 


data to receiving data. The (time) defined is a parameter of a compiler algorithm for calculating the 


_ initiate transmit delay. Refer to the semantics of the (con trol definition) or (request definition) 


(initiate statement) in this chapter for more information. This attribute must be defined for each 
terminal definition). | | | a a 7 
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Terminal Width Statement 


TERMINAL WIDTH STATEMENT 


I 


Example 
WIDTH = 80. 
Semantics 


The terminal width statemen t) defines the width, in characters, of a display line of output on the terminal 
type. The (integer) must be greater than 0 and less than 256; additionally, the value of the (integer) must _ 
be less than or equal to the size defined in the (terminal buffer size statement), if present. Itisnot 
required that the (terminal width statement) appear ina (terminal definition). If the (terminal width 
statement) is not defined in the (terminal definition), then the buffer size value is substituted for this 
value, if present; otherwise, the value of MAXINPUT is substituted by default. : 
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+ PERMINAL WRU CHARACTER STATEMENT 
Syntax © | _ 


WRU ————— oo ¢ single character) = 


_ Examples 


WRU = 4"2D” (DYNAMIC). 
WRU _ hl dead " : 
Semantics a 1 Be - _ _—s 8 
The (terminal WRU character statement) defines the WRU character for the terminal type (ie., the 4 
character the terminal type would transmit to request a response from the DCP). If defined, the WRU 
- character can be recognized by the DCP when RECEIVEd (ina (receive statemen t)), and any action to be 


taken can be specified by the programmer (using the WRU syntax). 7 i 
(DYNAMIC) indicates that the Message Control System of .a station referencing the (terminal definition) 
is allowed to change the character for ghe station by means of the SET CHARACTERS (TYPE=39) | 
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TRANSLATETABLE DEFINITION | 


Syntax 
TRANSLATETABLE »¢ translatetable identifier jae ( source size )~>( »( string —— TO Loe single character 
| | mC SOUPCE \— TO sae esiialion, 
EBCDIC >TO —e (standard natietes set) 
, (standard character set) >TO EBCDIC 
liranstarétable identifier) | 
Examples 


TRANSLATETABLE ATABLE  8(‘“STRING” TO “X”). 
TRANSLATETABLE BTABLE 8(4“000102” TO 4“AABBCC”). 
TRANSLATETABLE CTABLE = 7(4“02820B” TO eA ccire 
TRANSLATETABLE DTABLE 7(400” TO 4“AA”), | 
| ETABLE = 8&(DTABLE, 4“01" TO 4“BB"). 
TRANSLATETABLE FTABLE — 84°00" TO 4“AA”), - : 
GTABLE 8EBCDIC TO BCL,FTABLE, 
. | 4“01"’ TO 4“BB”). 
-TRANSLATETABLE TRANID  7(‘‘1” TO 401”, 
: * —)” TO 4°‘02”’. 
“34” TO 40304”, 
4“F5F6” TO 40607”). 


Semantics _ 


The (translate table definition) allows the definition of tables that may be used in {con trol defi inition) s 
or (r equest definition) s t to translate characters of one character set to those of another character set. _ 


Translation tables need to be defined in an NDL program only if non-standard character sets must be 

dealt with in the Data Communications System. Terminals that transmit and receive a standard character 
set do not require a translation table definition; instead, the character set is merely named in the (terminal | 
code statement) of the Germinal definition). The character sets that do not require a ee : 
definition) are ASCII, BAUDOT, BCD, BCL, EBCDIC, and PTTC/6. 


The ¢ /translatetable identifier) that follows the key word TRANSLATETABLE names s the translation table, | 
and must be in the syntactic form of an (identifier) . | 


(source size) defines the character size, in bits, of characters to be translated. (so source hea! ust bed an 
/integer) greater than 0 and less than 9 Ae 


TRANSLATION TABLE STRUCTURE 


Each element of the translation table consists of eight bits. IfN represents the i eaaiien size), then the size 
of the table is 2 raised to the Nth power. The elements of the mele are selected bya an index that ranges 
from 0 through 2 to the Nth power minus I. 


At execution time, translation i is done in the following manner. The bint weight of the low-order oo. 
N bits of the character to be translated is used as ‘an index into the specified translation table. The element ae 
of the table thus indexed is the translated result. | : he oa 4 
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INSERTING DATA INTO THE TRANSLATION TABLE 


Every translation table has a default base in which each clement in the table is 0 (all bits off). Data can ‘be 


placed into the translation table by various specifications within the parenthescs. If more than one * 
specification appears for a given translation table, each succeeding specification: overrides, within its scope, _ 
previous specifications. 7 os - Mh ah 


(stringy TO (single character) 


- This form inserts data into the translation table in the following manner. Each eight-bit character in the . 


(stringy is examined from left to right. If a character in the (string) is numerically greater than the size — 
of the table, no entry is placed in the translation table; otherwise, the (single character) is stored-in the | 
element of the table whose index is the binary weight of the N low-order bits of the (string). character 7 
(where N is the (source size) specified). | : | | ar or 


(source) TO (des tination) 


(source) and (destination) must be (string)s of equal length. This form of specification inserts data into 
the translation table in the following manner. Translation is based upon corresponding charactersin | 
wsource) and (destination) , starting from left.and proceeding to right. The first character of (source) 
corresponds to the first character of (destination) , the second character of (source) corresponds to the — 
second character of (destination), etc. If a character in (source) ‘is fumerically greater than the size of the 
table, then no entry is placed in the translation table; otherwise, the corresponding character in 
(destination is stored in the element of the table whose index-is the binary weight of the N low-order bits 
of the corresponding character in Gource), | i4, * | i. 3 4 


_ standard character se!) TO EBCDIC and EBCDIC TO (standard character set) 


This form specifies a standard system software translation table from the NDL compiler that is to be 
copied into the translation table. The (standard character sets that may. be specified are EBCDIC, .— 


ASC67, and BCL. These forms provide a way of obtaining a legitimate base upon which additional. 


specifications can be made. - A” g 

(translate table identifier) ne r= | | py ? ee 

This form of specification indicates that the contents of a previously defined translation table is to be 
copied into the translation table. | The (translatetable identifier) must be the. <iden tifier) of a-previously 
defined translation table, This form provides a means of obtaining a legitimate base upon which additional 
specifications can be made. _ mee & wee Se | —_ 


Pragmatics | , CR ee ea | | 
Those tables, and only those tables, that are used by a DCP reside in the local memory of that DCP (unless 
a DCP does not have local memory, in which case they reside in main system memory). Memory for. 
translation tables is allocated in blocks of 256 words, regardless of the space required for those tables. 
Tables are densely packed and all elements are used before another block of 256 words is allocated. Unless 
consideration is given to the translation requirements of devices in the data communications system while in 
the planning and programming stages, translation tables can be very costly in terms of local memory. — 
Although it is beyond the scope of this manual to describe the planning of a data communications system, — 
this fact should not escape the NDL programmer. ee me oseek et 
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Supplementary Examples 
Example | a Ske 
TRANSLATETABLE ATABLE 8(‘‘STRING” TO “X”). 
Character to be Translated _ | | Result | 
“se esyee? 
act liad “y” 
7 “R” | . | ; a> ied ; 
ta) (id . : i, ae 
. oS A hd . “oy? 
“GC” . a Ge 


ATABLE isa translation table containing 256 elements. The (source size), 8 in this example, deter- 
‘mines the table size. All characters from <source) are translated to the (single character). : 


Example 2 | — = | 
TRANSLATETABLE BTABLE 8(4“000102” TO 4“AABBCC”). 
| | Character to be Translated : | - Result 
2 
; 4°01” | : | . 4“BB” . | | : | . 7 
402” —— . 4*°CC” : | : a 


BTABLE contains 256 elements. Characters from ¢ source , 4000102”, are translated to the 
corresponding characters in the (destination), 4“AABBCC”. The character 403” is translated to” 
400” because there is no specification in (sourcey for 403”. eae at 2 


Example 3 | 
TRANSLATETABLE CTABLE 7(4“02820B” TO 4“AACCDD”). 
| Character to be Translated | — Result 
aor 400" 
| 4°02” | | | ; | | 4“AA” 
4°82” 3 = ; 7 4“ AA” | 
4“0B” 7 | 4“DD”’ 


In this example, the translation table CT ABLE contains 128 elements. The character 4°01” is 
translated to a 400” character, because 4“01” is unspecified in the ¢ source). The character 482” is 
translated to the character 4“AA” because only the low-order seven bits of 482” are used to index - 
the translation table. | ta | — re ee es 


Example 4 } es | a. 
TRANSLATETABLE DTABLE 8(4“00" TO 4“AA”). 

| ETABLE 8(DTABLE, 401” TO 4“BB”). | 
The above ¢ translatetable definition) defines two translation tables: DTABLE and ETABLE. Ail 
clements in DTABLE contain 400”, except the element indexed by the character 400”; thatelement ~ 
contains 4“AA”. ETABLE specifies DTABLE as a base, and then modifies that base with a subsequent — \w-/ 
specification. — 6% =e oe ¢ . 
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Example 5 


TRANSLATETABLE FTABLE 8(4‘00” TO 4“AA”). 
GTABLE 8(EBCDIC TO BCL, FTABLE, 401" TO 4“BB”). 


GTABLE is defined to contain 256 elements, and specifies the standard EBCDIC-to-BCL translation 
table upon which subsequent specifications modify. FTABLE also contains 256 elements and 
appears as a specification in GTABLE. Since each succeeding specification overrides within its scope 
any previous specification, FTABLE in effect Overays all elements. The result i is the same as if only 
the following had appeared: | 


TRANSLATETABLE FTABLE & 400” TO 4“AA”), | 
_GTABLE 8(FTABLE, 4°01” TO 4“BB”). 


The above example points out that any table appearing as a specification indicates all: élenieints of that 
table, not just those elements explicitly defined. The example i is not intended to illustrate ¢ an ie | 
able programming practice. 
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6. VARIABLES | 
GENERAL | 


The NDL compiler does not allow a programmer to declare and use program variables, as do other language 


compilers such as ALGOL, PL/I, and COBOL. Instead, the NDL programmer can use only predefined © 
proyram variables. | | | : a . * wo 
The (bit variable)s and ‘byte variable)s are the two types of variables the programmer can use. The < bit 
variables are one-bit variables that can only assume logical values (i.e., TRUE or FALSE)... The byte | 
variable) s are all eight-bit variables, and can assume integer values from 0 through 255, except for the IR 
variable, which is a 10-bit variable. The IR variable is included as a (byte variable) as a matter of | | 
convenience. : | : a : | : i. 


Individual bits of a (byte variable) can be referenced and used like a bit variable), if referenced in the 
form illustrated below. 7 Me | = | 


| ( byte variable ) —_—— q ——__—_——t» ( bit number) ——_——> ] re 


where (bit number) is an (integer) not greater than che number of bits contained in the variable minus 1. : 
For Scamiple: bit 5 of IR is referenced as IR[5]. a : 
FUNCTION OF VARIABLES 7 
Functionally, variables fall into one of three general saleeeties : 
a. Variables that are available to the programmer for general angermmaticn storage. - 
" Variables that can be used for speichnlet doiicommounication ; _ 
c. Variables that contain control information. 
General information variables - be used within their scoue a the ouaniiet for dita ene. calcula- 


tions, etc. Additionally, some variables in this category could (by convention) be used as communication 
paths between (request definition) s executing ona given line. (The use of a given variable for this appli- 


cation is restricted by the scope of that variable.) 


Variables whose intended function is communication to and from the main system and stations are gener- 
ally contained in the message header of a message sent to the main system from a station, or sent to the 
station from the main system. Messages from the main system to a station are originated either by the MCS 
or by an application program (via the 1/O Intrinsics). > ye poy ee ee 


The format of message variables within a message header is described in detail in the B 6700/B 7700 — | 
DCALGOL Reference Manual. Generally, message variables are contained in five fields of the message header: 


a. Message Toggles (word [1] .[39:8]) 


- b. Message Tallys (word (3].[23:24]) 
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c. Message Error Flags (word [1] . [23:24]) 
d. Variant “Carriage Control” (word [0] . 139:16]) | 
e. Message Retry Count (word [2]. [47:8]) 


Message Toggles and Message Tallys provide storage area in the header for some . the station general infor- 
mation variables. The meaning of values stored in these fields must be established by mutual convention be- 
tween the MCS writer and the NDL programmer. 


Message Error Flags are used for the station to communicate to an MCS that some exceptional event has 
occurred in a ¢ request definition) or (control definition ). These variables reference bits in the message 
header of “result” messages returned to the MCS as a result of execution of a (terminate pigtement) 


Carnage Control is valid for Transmit Requests, and provides information ese edie the kind of carriage 
control to be performed by a Transmit Request. These variables reference bits or Boe in the. message 
header of WRITE (TYPE=33) DCWRITE messages. 


The Message Retry Count is deseribed under RETRY in this chapter. 
Variables whose function is to contain control information are used by both the DCP operating system and 


the programmer. Generally, these variables provide information to control the logic paths of one 
definition) s, (request LLL LL and the DCP operating ce | 


SCOPE OF VARIABLES > 7 a a = 7 St: | A 
The scope of the variables in NDL is deseribed as being: 

a. Station-oricnted. 

b. Line-oriented. 

C. Global. 
Station-oriented variables cxist for each station in the network. TALLY {O] is an exarnvle of z a eon 
oriented (byte variable): thus, cach station has its own TALLY [0]. The variables oy a gwen station arc 
visible to a line only while STATION is set to that station’s ‘‘station index.” 
Line-oriented variables exist ‘i each line on a DCP. The variables of a given line are visible to every station 
assigned to that line. MAXSTATIONS is an example of a line-oriented variable. Each line on a DCP has its 
own MAXSTATIONS, and every station assigned to a given line can access the MAXSTATIONS variable of 
that line. 
A global variable is a variable that is visible to all stations on a DCP. 
DESCRIPTION OF VARIABLES - 
The remainder of this chapter contains descriptions of each (bit variable) and (byte wanabIes The variables 


(listed in table 6—1) are described in alphabetical order. The name of the variable precedes a summary ofthe wy 


variable characteristics, followed by a detailed description of the variable. 


( 
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The summary of the variable characteristics includes the places in the source program that the variable can 
be interrogated or altered, and the size, in bits, of the variable. In the summary, the word “Interrogate”’ 
indicates that the programmer can interrogate the variable. The word “Alter” indicates that the. programmer 
can use the (bit variable >| byte variable) as an (assignable bit variable ) | (assignable byte variable). The . 
corresponding letters “C’”’, “T’”, and “R”’ in the summary refer to (control definition), Transmit Request, . 
and Receive Request, respectively. The last item to appear in the summary is the size, in bits, of the variable. 
If no size is defined, then the size of the variable is one bit. —— es | | | 


For example, the summary: 


EXAMPLEL 
interrogate, CTR, 8 


can be expanded as follows: 


EXAMPLE] is an 8-bit variable. It can be 
interrogated in a (control definition). 
Transmit Request, or Receive Request. 


The summary: 


EXAMPLE2 sy | 
Interrogate/Alter, CTR/TR 


can be expanded as follows: 


EXAMPLE? is a (bit variable). It can be 
interrogated in a (control definition) , 
Transmit Request, or Receive Request. 
Additionally, EXAMPLE2 can be altered 
(i.e., appear as an (assignable bit variable) 
in a Transmit Request or Receive Request, — 
but not in a (control definition). 


Table 6—1 contains the summaries of each variable for quick reference. 
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Table 6--1. Table of Variables — 
SIZE 
(in bits) 
ADDERR 


Al 

AUX (LINE (BUSY)) 

AUX (LINE (QUEUED)) 
AUX (LINE (TALLY [{0 or 1}] 
AUX (LINE (TOG [{0or/}] 
BCC | 
BCCERR 

BLOCK 

BLOCKED 

BREAK [RECEIVE] 
BREAK [TRANSMIT] 
BUFOVEL - 

CARRIAGE | 
CHARACTER 
CONTROLFLAG 

CRC 

CRC | 10 or It] 

CRCERR 

DISCONNECT 
ENDOFBUFFER | 
FORMATERR 
INHIBITSYNC 

IR a 

LINE (BUSY) — 

LINE (QUEUED) - | 
LINE (TALLY [}0 or 7t] . 
LINE (TOG [{0 or J }] 
LINEFEED 
LOSSOFCARRIER 
MAXSTATIONS 
NAKFLAG 
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NAME 


NAKONSELECT 
NOSPACE 
PAGE 


‘PAPERMOTION 


PARITY 

RETRY 

SEQERR 

SEQUENCE | 

SKIP | 
SKIPCONTROL 

SPACE 

STATION — 3 
STATION (ENABLED) 
STATION (FREQUENCY) 
STATION (QUEUED) _ 
STATION (READY) 
STATION (TALLY) 
STATION (VALID) 
STOPBIT | 
SYNCS . 

TAB 


TALLY [ (tally number) | 


TIMEOUT 


TOG [ (toggle number)| 


TOGS 
TRANERR 
WRUFLAG 


Table 6—1. Table of Variables (Cont) 


SIZE 
(in bits) 
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ADDERR 
Interrogate/Alter, CTR/CTR 


ADDERR refcrences bit 8 in the Error Flug Ficld of a message header, and normally indicates that an. address 
character error has occurred while executing a (receive statement »). Refer to the ADDRESS option of the 
(receive statement). | 


Al 
Interrogate/Alter, CTR/CTR, 8 


This variable sdidiesece a volatile register and should not be oe, for data sianine: Its main purpose is to | 
allow access to the untranslated byte just received rather than to the translated byte in CHARACTER, 
particularly when executing the (sum statement). 


AUX(LINE(BUSY)) 
Interrogate/Alter, CTR/CTR 


AUX(LINE(BUSY)) is used to allow. or inhibit the interruption. of the execution of a C control definition) 
or (request definition) on the auxiliary line of a full duplex line pair. If this. bit is TRUE, it.indicates to the 
DCP operating system that the line is engaged in functions that must not be interrupted. ‘If FALSE, it indi- 
cates to the DCP operating system that the line can be interrupted to initiate another function. 
AUX(LINE(BUSY)) is line-oriented; but may be altered only by the auxiliary line. Both the auxiliary and 
primary line may interrogate this bit. | 


A (control de finition) or (request definition) will be interrupted when AUX( (LINE(BUSY)) i is FALSE if 
the primary line executes a (fork statement). (Note that an interruption causes control to leave a rate 
definition) or (request definition) and that control is not returned to the point where the teres | 
occurred.) AUX(LINE(BUSY)) is set TRUE by system software when: | | 


a. The primary line executes a (fork statement) and AUN TINE(RUSY))) is FALSE o or 
b. The auxiliary line (control definition) is entered, or 
c. The auxiliary line enters a Receive or peepee Request. 


If AUX(LINE(BUSY)) i is TRUE when the pumaty" line executes a. ag fork statement ms the < fork statement) 
will act asa no-op. 


(C 


(C 


responsibility of the programmer to initialize BCC 


2 yuiniebies 


: | Continued . 


AUX(LINE(QUEUED)) 
Interrogate/Alter, CTR/CTR 


This is a line-oriented (bit variable) that refers to the queued status of the auxiliary line ofa full duplex line 
pair. The bit is set by the DCP operating system if and when an input message space is explicitly acquired 


by executing a (getspace statement) on the auxiliary line. 


AUX(LINE(TALLY [{0 or /}])) 
Interrogate/Alter, CTR/CTR, 8 


These are line-oriented (byte variable) s for the auxiliary line of a full duplex line pair, and can be used for 
any purpose by the NDL programmer. They. can be accessed by either the primary or auxiliary line at any 
time. | ae aero | * : ipa isla: 


AUX(LINE(TOG [{0 or /}])) 
Interrogate/Alter, CTR/CTR 


These are line-oriented (bit variable)s for the auxiliary line of a full duplex. pair, and may be used for any 
purpose by the NDL programmer. They may be accessed by either the: primary or auxiliary line at any time. 


BCC 
Interrogate/Alter, CTR/CTR, 8 | 


BCC is used by system software for the purpose of accumulating a Block Check Character when a station 
(terminal definition) defines horizontal parity as ODD or EVEN in the ¢ terminal parity Statement). 


Block Check Character accumulation is an automatic function, if appropriate, of the (receive statement) 

and ¢ transmit statement). Block Check Character accumulation is based upon execusive-OR logic, that is, 

as characters are received or transmitted, they are exclusively OR-ed with the contents of BCC. It is the - 
vhen appropriate. (Refer to the (initialize statement) 


under (request definition) or <control definition).) 


If a station (terminal definition) does not define horizontal parity, BCC can be used as a temporary data 
storage area. It should be pointed out, however, that the value in BCC is destroyed by most constructs of 
the (terminate statement). Furthermore, since the intended purpose of BCC is to contain parity information, 
BCC and CRC[0] address the same data space. BCC cannot be used if a terminal uses Cyclic Redundancy 
Check. : Pe - «3 


When accumulating a Block Check Character, a convenient means to eliminate a specific character from the 


value accumulated in BCC is the (sum statement). 
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BCCERR 
Interrogate/Alter, CTR/CTR 


BCCERR refers to-bit 7 in the Error Flag Field of a result message, and conventionally indicatesthata 
horizontal parity (BCC) error occurred while executing a (receive statement). Refer to the semanitics of the: 
BCC option of the (receive statement). ess 7 _ | a 


BLOCK 
Interrogate, T 


This bit references bit 29 in word zero of a message header. If TRUE, this bit indicates that more blocks (or 
messages) of a blocked transmission are to. follow. Use of this bit implies a.convention between the MCS and _ 
the NDL programmer for the purposes of providing blocked transmissions. 7 


BLOCK is set TRUE im plicitly as a result of execution of.a TERMINATE BLOCK construct in a Receive ; 
Request. | ce | | a 


BLOCKED 
Interrogate, T 


A synonym for BLOCK. Refer to BLOCK. 


BREAK[RECEIVE] 


Interrogate/Alter, CTR/CTR 


This (bit variable) refers to bit 3 in the Error Flag Field of a message, and normally indicates that a break» | 
condition was sensed in a (receive statement). Refer to the semantics of the BREAK option of the (receive 
statement). | a man | _ a 


Note that if this bit is TRUE in a message to be returned to the MCS, the message is returned as a STATION | 
EVENT (CLASS=1) message. Refer to the B. 6700/B 7700 DCALGOL Language Reference Manual for more 
information regarding this message. | | 3 


BREAK[TRANSMIT] __. 
Interrogate/Alter, CTR/CTR 


This ¢ bit variable ) ref ers to bit 5 in the Error Flag Field of a. message, and normally indicates that a break | - 
condition was sensed while executing a (transmit statement). Refer to the semantics of the BREAK option 
‘of the (transmit statement). 7 - : | | 


Note that if this bit is TRUE in a message to be returned to the MCS, the message is returned as a STATION 


EVENT (CLASS=1) message. Refer to the B 6700/B 7700 DCALGOL Language Reference Manual for more | 
information regarding this message. ‘ | | . a ee 
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BUFOVFL 2 4 
Intcrrogate/Alter, CTR/CTR 


This (bit variable) refers to bit 2 in the Error Flag Field of a message, and normally indicates. that a cluster 
buffer overflow condition occurred while executing a (receive statement). Refer to the semantics under the 
BUFOVEFL option of the (receive statement). — 8 . ~~ i ae 


CARRIAGE 
interrogate, T 


CARRIAGE is a carriage control variable, and is used to indicate if a carriage return is desired at the comple- 
tion of the text transmission. | . 2 hes 


CARRIAGE is TRUE if message word [0] . [25:1] is zero. 


This bit can be set by the 1/O Intrinsics for a data communications file, or by the MCS. 


CHARACTER | 7 
Interrogate/Alter, CTR/CTR, 8 


CHARACTER is a line-oriented (byte variable). 


CHARACTER contains the last character TRANSMITted or RECEIVEd on the line, unless otherwise altered - 
by a (fetch statement) or an (assignment statement). - a | - m 


CONTROLFLAG | | 
Interrogate/Alter, CTR/CTR 


This (bit variable) refers to bit 12 in the Error Flag Field of a message, and normally indicates that the 
station defined control character was received. Refer to the CONTROL option of the <receive statement). 


Note that if this bit is on in a message to be returned to an MCS, and the first character of the message is the 
control character of the station, the message is returned as a STATION EVENT (CLASS=1). Refer to the 
B 6700/B 7700 DCALGOL Language Reference Manual for more information regarding this message. _ 


CRC ) _ 
Interrogate/Alter, CTR/CTR _ 


In (request definition)s and (control definition’)s that use the Cyclic Redundancy Check, system software 
tests the status of the (bit variable) CRC before the execution of any (receive statement) or (transmit _ 
statement ). If CRC is TRUE, the byte (or bytes) transmitted or received are calculated into the Cyclic 
Redundancy Check stored in the (byte variable)s CRC[0] and CRC[1 ]. If CRC is FALSE, bytes transmit- 


ted or received do not affect the Cyclic Redundancy Check. 
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CRC{{0 or 1}) 
Interrogate/Alter, CTR/CTR, 8 


System software uses the byte aiiaki CRCIO] and 4 CRC{A] as a concatenated 16-bit information field | 
to contain Cyclic Redundancy Check information for those stations whose (terminal définition)s define. 
horizontal parity as CRC(16). If the (bit variable >) CRC is TRUE, Cyclic Redundancy Check calculation is 

- done using CRC[0] and CRC[1] asa 16-bit field, and. the characters TRANSMITted or RECEIVEd. it CRC 
is FALSE, Cyclic Redundancy Check calculation is inhibited. | 


If a station (terminal definition) does not define horizontal Sain then CRC 0) and eRci1]} can be used 

as a temporary storage area. It should be pointed out, however, that the values i in CRC[O] and CRC{1] are | 
destroyed by most constructs of the (terminate statement). Additionally, since the intended purpose of 
these variables is storage of parity information, CRC[Q] and BCC address the same byte. CRC[O] © 

cannot be used for temporary data storage if the (control deftattion) or (request — uses BCC for 
Block Check Character accumulation. | | | 


| CRCERR | | 
: Interrogate/Alter, CTR/CTR © 


| CRCERR references bit 7 in the Error Flag Field of a result message, and conventionally indicates that an 


error in the Cyclic Redundancy Check occurred while executing a A receive bcvarivented Refer to the seman- 
tics of the CRC option of the (receive Statement). : | 


DISCONNECT 
Interrogate/Alter, TR/TR 


DISCONNECT. seierentes bit 12: in 1 the Error Flag. Field of a message, and indicates that a | disconnect occur- : 
: red on the line while aires a a erring ae Ps 


ENDOFBUFFER | eget . a 
Interrogate/ Alter, TR/TR a ro 


EN DOFBUFFER peices bit 17. in the Error Flag] Field of a ceeauit § message, “and j is. poitinbitipaiy® used by 


a (request definiticn) to indicate when an overflow of the text buffer has occurred. Refer to oe semantics a" - 


of the ENDOFBUFFER option of the {re receive ne. 


FORMATERR- : 
Interrogate/Alter, TR/TR, 


This bit references bit 103 in. ‘the Error Flag Field of a cal message, . and’ is conventionally aed to indicate: ie 
that a format error occurred while errenting a ie receive: e statement -— Refer to the » RECEIVE | string) construct 
of the (receive statement). ee oe Faas oe en ee ee 
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INHIBITSYNC | 
Interrogate/Alter, CTR/CTR 


INHIBITSYNC is a line-oriented variable that causes actions as described under the (terminal inhibitsync 
statement). | : . a ee | i 


IR 
Interrogate, CTR, 10-bit | 
IR addresses the 10-bit Input Register of the adapter cluster. This register contains hardware related control 
and data information for a line adapter. — 7 | ‘gg ¢@€ “  .* 7 oo 


IR can be interrogated using a (bit number) specification. (bit number)s for IR range from zero through 9. 
For example, IR[O] addresses bit number zero of the Input Register. _ : ee eG 


Refer to the Burroughs Data Communications Processor Reference Manual or the DCP Reference Card for 
the meaning of the bitsinIR. | rca — A one, 


LINE(BUSY) oe 
Interrogate/Alter, CTR/CTR 


LINE(BUSY) is a line-oriented control information bit, and is used to allow or inhibit the interruption of 
the execution of a (control definition) or (request definition) on a single line. In the case of a full duplex — 
line pair, LINE(BUSY) refers to the primary line. If this bit is TRUE, it indicates to the DCP operating _— 
system that the line is engaged in functions that must not be interrupted. If FALSE, it indicates to the DCP 
operating system that the line can-be interrupted to initiate another function. LINE(BUSY) can be altered 


only by the primary line of a full duplex line pair. 


A (control definition) or (request definition) is interrupted when LINE(BUSY) is FALSE if the DCP re- 
ceives in its Request Queue a station-oriented DCWRITE message, and STATION(QUEUED) is FALSE for | 
that station. If the message is a READ - ONCE ONLY (TYPE=34), STATION is.set to that station index, . 

and control is transferred to the Receive Request for that station. If the message is a WRITE (TYPE=33) 
DCWRITE message, STATION is set-to that station index, and control is transferred to the Transmit Request 
for that station. If the message TYPE is neither of the above, the function associated with the message is 
executed and control resumes at the beginning of the line (control definition) , witn the value of STATION: 
equal to the index of the station for which the function was initiated. (Note that an interruption causes con- 
trol to leave a (control definition) or (request definition), and that control is not returned to the point where. 
the interruption occurred.) a es ; ph oe 7 os 
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ae 
Variables 


Continued _ 


LINE(BUSY) is sct TRUE by system software when: 
The (control definition) i is entered, 
b. A request definition) i is entered, or 


c. The line is the primary of a full duplex line pair, LINE(BUSY) is F ALSE, and the auxiliary line eX- 
ecutes a ( fork statement). 


Note that if LINE(BUSY) is TRUE when the auxiliary line of a full opens line pair executes a (fe fork state- 7 
ment), the (fork statement) acts asa no-op. _ | | 


_ LINE(QUEUED)  — 
Interrogate/Alter, CTR/CTR 


LINE(QUEUED) is a line-oriented variable used to indicate whether or not (TRUE or FALSE, peapectivels) 
a message has been queued for any station on the line. It is set TRUE by system software when a message 
is inserted into an empty Station Queue of a station assigned to the line. It is the programmer’ S peeponatyy 
ity to set it FALSE when appropriate. | 


LINE(TALLY{{0 or /}1) _ Ae. or 7 Na 
Interrogate/Alter, C TRICTR, 8. 7 : | - _ ae 


-LINE(TALLY l{ Qorl H ) are line-orlented variables for data storage, etc., available to the: programmer. | 


-An MCS may dynamically alter the line tallies sby performing a SET/RESET LINE TOG/T ALLY (TYPE=1 03) 
DCWRITE request. 


LINE(TOG{{ 0 orth) | 
Interrogate/Alter, CTR/CTR | | 


LINE(TOG i Qorl ty ) are line-oriented variables for general information storage, etc., available to the pro- 
grammer. , oth | 


An MCS may dynamically alter the line toggles by performing a SET/ RESET LINE  TOG/TALLY (TYPE=103) 
DCWRITE request. | 


LINEFEED 
Interrogate, T 


LINEFEED is a carriage control variable and is TRUE when message word [0} . (24: 1] is zero. If TRUE, 
LINEFEED indicates that a new line is required at the completion of the text transmission. This bit c can be 
set by the 1/0 Intrinsics for a data communications file, or by ue MCS. 


«( 


(C 


Variables — 


_- Continued - 


LOSSOFCARRIER 
Intcrrogate/Alter, CTR/CTR 


LOSSOFCARRIER references bit 18 in the Error F lag Field of a aul message, and is weiadiiiedis used 
to indicate that a loss of carrier occurred while executing a ¢ receive statement). Refer to the 
LOSSOFCARRIER option of the ( receive statement). 


MAXSTATIONS 
Interrogate, CTR, 8 


MAXSTATIONS is a line-oriented (byte variable) whose value is the maximum number of stations that can 
be assigned to the line. 


MAXSTATIONS is initialized to the value defined in the (line maxstations sittin of the <line defini- 


tion). If the (line maxstations statement) does not appear ina (line definition) , then MAXSTATIONS is 
initialized to the number of stations listed in the (line station statement). If neither statement appears, 
MAXSTATIONS i is zero. | 


Within a (control definition) , the valid range of values which r may t be assigned to the es byte ed, STATION 
is between zero.and MAXSTATIONS -1, inclusive. | | | 


NAKFLAG 
Interrogate/Alter, TR/TR 


NAKFLAG references bit 11 in the Error Flag Field of a result message, and conventionally indicates that a 
transmission was NAKed by the terminal. This bit is not set by aye software, and its use is at the option 
of the programmer. , 3 


NAKONSELECT | 
Interrogate/Alter, TR/TR 


NAKONSELECT references bit 16 of the Error Flag Field of a result message, and i is conventionally used to 
indicate that a Transmit Request was NAKed when it attempted. to select the terminal. This bit is not set by 
system software, and its use is at the option of the programmer, 


NOSPACE 
Interrogate, CTR 


NOSPACE is a global variable that, ain TRUE, indicates that a “no. space’ ’ condition exists in the available 


space pool. NOSPACE is set By system software when the condition exists, and reset when the condition no | 
longer exists. 7 | 
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PAGE 
interrogate, T 


PAGE is a carriage control variable, and conventionally indicates whether a new page is requited for the out- 
put device. For example, on a screen device, PAGE = TRUE could indicate to the Transmit Request that a_ 
home/clear sequence should be transmitted before or after the text is transmitted to the terminal. Refer to- 
PAPERMOTION. | | =. 


PAGE is set TRUE is message word {O].[26:1] = I. 


PAPERMOTION 
interrogate, T 


PAPERMOTION Is a carriage control variable that is conventionally used to indicate whether carriage control 
‘s desired before or after the message text is transmitted. If message word [0] .[30: 1] =1, PAPERMOTION 
is set TRUE, and carriage control should be done before the text is transmitted; otherwise, carriage control 
after the text is transmitted. | ;  @ 


PARITY 7 
Interrogate/Alter, CTR/CTR 


Piles 


PARITY references bit 6 of the Error Flag Field ina result message, and indicates that a vertical parity error Maye 


was detected when exccuting a Crece/ve statement). Refer to the PARITY option of the (receive statement). — 


RETRY 
Interrogate/Alter, CTR/CTR, 8 


RETRY isa station-oriented variable, and is referred to as DCP RETRY. 


The purpose of DCP RETRY is to record the number of attempts a Crequest definition) has made to com- 
municate with a terminal but failed as the result of some abnormal condition. Conventionally, the NDL 
programmer decrements RETRY (i.c., DCP RETRY) by one foreach unsuccessful attempt at an operation | 
until RETRY equals zcro, then executes a TERMINATE ERROR. | | 


When a (request definition) is initiated by the DCP, DCP RETRY is implicitly set to an initial value called 
DCP INITIAL RETRY. The default value of DCP INITIAL RETRY is specified by the NDL program in the 
(station retry statement). | 


By using the Message Retry Field in the message header (message word [2] .[47:8]), the MCS can control 
the value assigned to DCP INITIAL RETRY, and therefore, is the initial value of DCP RETRY. If the 
Message Retry Field is 255, the value specified in the (station retry statement) assigned to DCP INITIAL 
RETRY, otherwise the value of the Message Retry Field is assigned to DCP INITIAL RETRY. The NDL | 
program can restore the value of DCP RETRY to the value of DCP INITIAL RETRY at any time by ex- 
ecuting the INITIALIZE RETRY construct. | 7 


All forms of the (terminate statement) which result in a message being returned to an MCS cause the ee? 
current value of DCP RETRY to be stored in the Message Retry Field of the result message. 
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SEQERR 
Interrogatc/Alter, TR/TR 


SEOERR references bit 14 in the Error Flag Ficld of a result message, and conventionally indicates that a 
sequence number overflow occurred as the result of the execution of an INCREMENT SEQUENCE con- 
struct. Refer to the (increment statement). | oe 


SEQUENCE _ 
interrogate/Alter, CTR/CTR 


SEQUENCE is a station-oriented bit that indicates whether or not (TRUE or FALSE, respectively) a 
(request definition is to perform automatic sequencing. SEQUENCE is controlled by aSET/RESET 
SEQUENCE MODE (TYPE=49) DCWRITE from the MCS. SEQUENCE can be set FALSE by the NDL 
program but can be set TRUE only by the controlling MCS. ‘SEQUENCE can be set TRUE only if the 
(request definition) for a terminal employs sequence num ber constructs such as TRANSMIT SEQUENCE, 
INCREMENT SEQUENCE, and STORE SEQUENCE. Use of automatic sequencing is the option and res- 
ponsibility of the NDL programmer. | . . tee @ ee i ae _ 


SKIP 
Interrogate/T 


SKIP is a carriage control variable. SKIP is used in conjunction with SKIPCONTROL to indicate a “‘skip to 
channel N” on an output device. If message word [0] .[27:1] = 1, SKIP is set TRUE and SKIPCONTROL 
contains the channel number to skip to. Both SKIP and SKIPCONTROL can be set by the 1/O Intrinsics 
for a data communications file, or by the MCS. | _ a 


SKIPCONTROL | 
Interrogate, T, 8 


SKIPCONTROL is used in conjunction with the (bit variable)s SKIP and SPACE. If SKIP is TRUE, then 
SKIPCONTROL applies to SKIP. If SPACE is TRUE, SKIPCONTROL applies to SPACE. If neither are 
TRUE, SKIPCONTROL is undefined. Both SKIP and SPACE should not be TRUE concurrently. Fora 
description of the function of this byte, refer to SPACE and SKIP. SKIPCONTROL is transferred to the 
Transmit Request in the message header of a WRITE (TYPE=33).DCWRITE in message word [0] [39:8], 
and can be set by the I/O Intrinsics for a data communications file, or by the MCS. er es oi 


SPACE . 
- Interrogate, T 


SPACE is a carriage control variable. : SPACE is-used in conjunction with SKIPCONTROL to indicate the 
number of vertical lines to skip. If message word [0] .[28:1] = 1, SPACE is set TRUE and SKIPCONTROL 


indicates the number of lines to skip. SPACE and SKIPCONTROL can be set by the I/O Intrinsics for a 
data communications file, or by the MCS. __ | | | | | | _ 


—66-15 


Variables 


Continued — 


STATION 
— Interrogate/Alter, C/C, 8 


STATION is a line-orientcd (byte variable) used ina (control definition) of a multi-station line to select a. 
particular station with which the (control definition ) wishes to interact. That is; to access the variables of 
a particular station, or INITIATE the Receive Request or Transmit Request of a station, the station index 

value associated with the station must be stored in STATION. -* — 


A station index value is associated with each station that is assigned to a logical line. At DCP initialization - 
time, station index values are assigned sequentially, beginning at zero, to each station on a given line in the 
order that the stations were named in the (line station statement) of the (line definition). = 


Atter DCP initialization, an MCS can: cause a station to be logically added to a line. When this occurs, a 
station index value becomes associated with the station. An MCS can also cause the logical removal of a 
station froma line. After such action, the station index value that was associated with the station no longer - 
references a valid station. Thus, alter DCP initialization, “holes” can exist in the sequence of valid station 


index values for a given linc. A station index value can be “tested” to determine if it references a valid sta- . 
tion by interrogating the STATION(VALID) (bit variable). — _ 


There is a maximum valid station index value associated with cach line. That value is determined either by: 
the Cline maxstations statement! > or by the (line station statement). (Refer to the (line maxstations state- 
ment) for more information.) This value can be obtained ina (control definition) by interrogating ) 
MAXSTATIONS. | i | * ie : 


STATION(ENABLED) 
Interrogate, CTR 


This is a station-oriented <bit variable) which refers to the “enabled” state of a station. When this variable 

is TRUE. the station is enabled for input, and the station Receive Request can be invoked. If — 
STATION(ENABLED) is FALSE, the station is disabled for input, and attempts to invoke the Receive Re- 
quest will be disallowed. : | _7F° =e | S SRT x * | 

The setting of STATION(E ABLED) is initially defined by the (station enableinput statement) inthe. 
station definition, and may. be altered by.an MCS via the ENABLE INPUT (TYPE=35) and DISABLE INPUT 
(TYPE=36) DCWRITE. a i, ce | . ef ee oe eo 


STATION(FREQUENCY) _ 
Interrogate, CTR, 8 | 


STATION(FREQUENCY) is a station-oriented ¢ byte variable), and is conventionally used to contain a 
relative polling frequency for polled stations. The initial value for STATION(FREQUENCY ) is supplied by | 

the (station frequency’ statement) fora station. It can be altered by an MCS via the ENABLE INPUT 
(TYPE=35) DCWRITE. Refer to the (station frequency statement). ee | 


 Nariables- 


oo Continued — 


STATION(QUEUED) | 
Interrogate, CTR, 8 


STATION(QUEUED) is a station-oriented variable that indicates whether or not (TRUE or FALSE, respec- 
tively) there are any messages (output or enableinput) in the station queue. Note that if this variable is 
FALSE. the execution of an INITIATE REQUEST construct acts as a no-Op. ae Se oe, 


STATION(READY) © 
Interrogate, CTR 


If STATION(READY) is TRUE, the station associated with the station index stored in STATION is logi- 
cally ready. No function (e.g., a Transmit Request or Receive Request) can be INITIATEd for the station 
if it is not ready. Stations can become not-ready as the result of the execution of a TERMINATE ERROR 
in one of its (request definition)s or as the result of the MCS executing a MAKE STATION NOT-READY | 
(TYPE=37) DCWRITE.. | p> * wie Uk CY ee : 


STATION(TALLY) __ 
Interrogate/Alter, CTR/CTR, 8 


STATION(TALLY) is a station-oriented (byte variable) and is a general purpose variable which may be 
used by the NDL program for data storage. The initial value of STATION(TALLY) is zero. Note that 
STATION(TALLY) differs from TALLY [ <tally number) in that it cannot be directly STOREd ina 
message header. | _—_ | DR oe . , 4 4 


STATION(VALID) | 
Interrogate, C | 


The STATION(VALID) bit indicates whether or not (TRUE or FALSE, respectively) there is a valid station 
associated with the station index value stored in STATION, Refer to the (byte variable) STATION. 


STOPBIT 


Interrogate/Alter, CTR/CT R . | | | 

STOPBIT references bit 1 in the Error Flag Field of a result message, and conventionally indicates that a 
stop bit error was detected while executing a receive statement). Refer. to. the STOPBIT option of the | 
receive statement). a Pe ee eee 


SYNCS | 
Interrogate/Alter, CTR/CTR | 
SYNCS is a synonym for INHIBITSYNC. Refer to the INHIBITSYNC description. | 
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TAB 
_Interrogate, T 


TAB is a carriage control vatable. and is conventionally used to indicate abuiation for the terminal. This” | 
bit is not set by I/O Intrinsics, and its. usc implics some established convention between the MCS and the NDL 
programmer. TAB. is sect TRUE if message word [0] .(30:1] = 1. | 7 7 . 


TALLY [(tally number) | 
Interrogate/Alter, CTR/CTR, 8 | 


TALLY [0], TALLY [1], and TALLY [2] are general purpose station-oriented (byte variable)s. They. can — 
be used for storage of 8-bit quantities such as counters, characters, etc. When the te is initialized, the 
TALLYs are initially zero unless a value is specified in a (station initialize statement). TALLYs may be 
initialized directly from a message header (message word [3] .[23:24]) by utilizing the INITIALIZE | 
TALLY [(tally number) | construct, thereby enabling an MCS to supply additional information to the DCP. 
The DCP can likewise transfer the value of a TALLY back to an MCS ina result message by utilizing the 
(store statement). Once a TALLY has been assigned a value, mat TALLY retains that value until explicitly. 

- altered by the NDL program. | 


TIMEOUT 
Interrogate/Alter, CTR/CT R- 


TIMEOUT references bit 0 (vero) of the Frror Flag Field ina result message, and conventionally indicates. 
that a timeout occurred while executing a (receive statement). Refer to the TIMEOUT option of the — 
(receive statement). | 


TOG [(toggle number) ] | 
Interrogate/Alter, CTR/CTR 


TOG [0] through TOG [7] are senceal purpose Wationotented bit canis éfen ee to as — 

They can be used for storage of logical values (TRUE and FALSE). When the DCP is initialized, the value of = 
the toggles is sct to the value specified in the (station initialize statement), or, if such initialization is not 
specified, the initial value will be FALSE. Toygles can be assigned a value directly froma message header 

(message word [1] .[39:8]) by utilizing the INITIALIZE TOG [ (toggle number | construct. Toggles can 

be stored into a result message by utilizing the (store statement). Once a toggle has been assigned a value, 

that toggle retains that value until explicitly altered by the NDL program. 


TOGS 
Interrogate/Alter, CTRICTR. 8 


TOGS addresses the eight (bit variable)s TOG[0} through TOG [7]. For example, TOGS = -4“FF” sets  & = 
TOG[0] through TOG [7] TRUE. TOG (Oy is considered the low-order bit, and TOG ve the eae — 
bit. 


6-18 


"Variables 


« _ | 7 “Continued 


TRANERR 
In terrogate/Alter, CTR/CTR 


TRANERR references bit 9 in the Error Flag Ficld of a result message, and i is éoaventionally used to indi- 
cate that a transmission number error occurred. Refer to the TRAN option of the creceive stateinen!). 


WRUFLAG 
jaterronate/ Alter: CTRICTR 


WRUFLAG references bit 13 in the Error Flag Field of a result message. If this bit is TRUE upon termina- . 
tion of a (request definition) , the result message is returned to the MCS as a STATION EVENT (CLASS = 1), 


message. Refer to the B 6700/B 7700 ear Language Reference Manual for more information sesh 


ing this message. 
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APPENDIX A. RESERVED WORDS 


The following is a complete list of reserved words used in the Network Definition Language. These ‘words 
have special meaning to the compiler and cannot be used as (identifier)s or in any manner other than their 
defined meaning. Any synonym of a reserved word is shown adjacent to the word, in parentheses. | 


ABORT BLOCKED . ~~— (BLOCK) ~~ 
ADAPTER (ADAPTOR) BREAK _ ° 
ADAPTOR (ADAPTER) = = ~——«&BUFFER” 
ADDERR BUFOVFL 
ADDRESS | | BUSY 
ALS os CARRIAGE — / * oe 
oF ALTERNATE — oo CHAR: _ (CHARACTER) 
ANSWER ss CHARACTER) = (CHAR) 
ASCII oes ; CLEAR” = 32 
ASC63 _ ; CLUSTERS 
ASC67 | a CODE 
ASC68 ; _ CONNECTION 
AUX. / (AUXILIARY) CONSTANT 
AUXILIARY (AUX) CONTINUE 
BACKSPACE _ (BKSP) ‘CONTROL 
BAUDOT 7 - RC a 
BCC * CRCERR © -(BCCERR) | 
BCCERR (CRCERR) pep oF Ga ees 
BCD 7 DEFAULT © 
BCL | 7 DEFINE © 
BEGIN a DELAY 
BINARY =e | | DIALIN _ 
BKSP | _ (BACKSPACE) © DIALOUT | 
BLKN a * DIFFERENT 
BLKNERR 6 ‘DIRECT | 
BLOCK ===~=—~——sC (BLOCKED) “DISCONNECT 


DOWN 

DUPLEX 

DYNAMIC 

EBCDIC 

ELSE 

ENABLED 
ENABLEINPUT 

END 

ENDOFBUFFER 
ENDOFNUMBER 

EQ — (EQL) 
EQL (EQ) 
ERROR | 
EVEN 

EXCHANGE 

FALSE 

FAMILY 

FETCH 

FILE 

FINISH 

FOR 

FORK 

FORMAT 

FORMATERR 
FREQUENCY 


Cc (GEQ) 
GEQ (GE) 


GETSPACE 


GT | (GTR) 
GTR (GT) 
HOME | 


‘RESERVED WORDS (Cont) 


HORIZONTAL 
ICTDELAY 
IDLE 

iF 


-TLLEGALCHR 
INCREMENT | 
INHIBITSYNC — (SYNCS) 


INITIALIZE 
INITIATE 
INPUT 

IR 


LINE a 
LINEDELETE | (LD) 
LINEFEED. 


~~ LOGICALACK 


LOGIN | 


-- LOSSOFCARRIER 


ES. *% 23% (LSS) 


_LSS (LS) 
-MAXINPUT sy | 


MAXSTATIONS 
MCS a 
MEMORY 


MICRO | 


MILLI 


MIN 
MODE 

. MODEM 
| _ MSGSPACE | 


LD - (LINEDELETE) 
LE (LEQ) | 
LEQ - (LE) 


MYUSE 
NAKFLAG 
NAKONSELECT 
NE 

NEQ 

NOINPUT 
NOISEDELAY 
NORMAL | 


‘NOSPACE 


NOT 
NULL 

ODD 
OUTPUT 
PAGE 
PAPERMOTION 
PARITY 
PASSIVE 
PAUSE 
PHONE | 
PTTC61 
QUEUED 


READY 


RECEIVE 
REMOTE 
REQUEST 
RETRY 
RETURN 
SCREEN 


SEC 
SECURITY 


SEQERR 
SEQUENCE 


(NEQ) 


(NE) | 


RESERVED WORDS (Cont) 


SHIFT | 


SKIP | 
SKIPCONTROL 


~ SPO 


STANDARD 
STATION 
STOPBIT | 
STORE 


| SYNCS | , (INHIBITSYNC) 


TAB 
TALLY 
TASK _ 


_ TERMINAL 
-~ TERMINATE 


TEXT 
THEN 


TIMELIMIT 


TIMEOUT 


TO 


TOG — 


“ToGs — 
TRAN | 


TRANERR 


_ TRANSLATETABLE 
~ TRANSLATOR. 
TRANSMISSION 


TRANSMIT 
TRANSMITDELAY 


‘TRUE | 
TURNAROUND | 


TYPE 


UP 
USER 


VALID 
WAIT 


RESERVED WORDS (Cont) 


WIDTH 
WRAPAROUND 
_ WRU 
_. WRUFLAG 


APPENDIX B. TRANSMISSION CODES 


BAUDOT CODE 


) 


— . BI 


EBCDIC BCL EBCDIC DECIMAL _ EBCDIC BCL BCL BCL USASCH 
GRAPHIC GRAPHIC HEX. INTERNAL VALUE CARDCODE OCTAL INTERNAL EXTERNAL CARDCODE X3.4-1967 
Blank 40 01000000 64 No Punches 60 11 0000 010000  NoPunches 0100000 
[ 4A 01001010 74 io 33 2 33 011011 111100 12 8 4 1011011 
4B 01001011 75 I2 8 3 32 01 1010 111011 12 8 3 0101110 
< 4C 01001100 16 12 8 4 36 011110 111110 12 8 6 0111100 
( 4D 01001101 77 12 8 5 35° = 01.1101 111101 12 8 § 0101000 
+ 4E 01001110 78 12 8 6 11 1010 010 1011 
| < 4F 01001111 79 12.8 7 37 O1 1111 111111 I> 8 7 41111100 
& 50 0101 0000 80 12 | 34 ~—-01: 1100 (110000 12 0100110 
4] 5A 0101 1010 90 11 8 2 76 111110 011110 0 8 6 1011101 
§ 5B 0101 1011. 91 11 8 3 52 101010 101011 11 8 3 0100100 
. SC 0101 1100 92 11 8 4 53 10 1011 10 1100 ll 8 4 0101010 
) 5D 0101 1101. 93 11 8 5 55 101101 101101 11 8 5 0101001 
SEs 01011110 94 11 8 6 56 ~—s-:10.11 10 10 1110 11 8 6 O11 1011 
_ < SF o1dl 1111 95 1 8 «7 57 10 1111 101111 11 8 7 | 
: 60 01100000 9 Ik. 54 101100 10.0000 11 101 1111 
; 61 0110 0001 : a a ae 61 11 0001 010001 oO 1 O10 1111 
6B 01101011 ~—«:107 0.8 3 £472 = ~~ 11-1010 O11011 Oo 8 3 101100. 
Sy 6C 01101100 108 = iCia8 84 OT if1011 01.1100 0 8 4 0100101 
_ ~ 6D 01101101 .. 109 oO 8 5 74° = 111100 01 1010 0 8 2 0101101 
>. 6E 01101110 110 0 8 6 16 00 1110. 00 1110 8 6 O11 1110 
2 6F 1101111 it 0 8 +7 14 001100 000000 * Ol Hl] 
7A 01111010... «:122—~—‘ WC CD 15 001101: 001101 8 5 011 1010 
# 7B. «COO 1011.~—:123 8 3 12 001010: 001011 g 3 0100011 
@ 7 01111100 124 8 4 13, 001011° 001100 8 4 100 0000 
> 7D 0111 1101 125 8 5 17 00.1111 00 1111 8 7 0100111 
= 7E 01111110 126 8 6 75  Iil0l- 011101 0 8 5 0111101 
: O11 1111 127 8 7 77 neeeee OL 1111 0 8 7 0100010 


DATA REPRESENTATION 


EBCDIC BCL EBCDIC 
GRAPHIC GRAPHIC HEX. INTERNAL 
(+)PZ + CO 11000000 
A C1 11000001 
B- C2 11000010 . 
C C3. +=11000011 
D> C4 11000100 
£ C5. 11000101 
F C6 11000110 
G -C7~~=—-:111000111 
4H C8 .1100 1000 
I C9 =: 1100 1001 
(!)M x po 11010000 | 
J , DI 11010001 
K D2. 11010010. 
L D3 1101 O01! 
M. D4 11010100. 
N. D5..-1101 0101 
O° D6 11010110 
Pp D7 =-11010111 | 
—.Q D&:-° 11011000 . - 
R D9 . 11011001... - 
og EO - 11100000 
“Ss -E2 11100010 - 
T. E3.. 11100011 ~~ 
U -E4 ° 11100100 
Vv. E5 11100101 
WwW. E6 11100110 
X E7 11100111 
YO E8 11101000 — 
ae’ A -E9 11101001. 
Oo | FO -— 11110000 
1 cs Fil —s-1111 0001 
20 2 ‘F2 11110010 
eis F3. 11110011 
4 


~ 21110100 —— 


192 
193 
194 
195 
196 
197 
198 
199 
200 
201 


208 
209 
» 210 


DATA REPRESENTATION (Cont) 


DECIMAL 
VALUE 


EBCDIC | 
CARD CODE OCTAL 


12 


12 - 


12 
12 
AZ 
12 
12 
12 
12 
12 


PWN O BDOCOOOOCOO- 


WO INMPWNMCOUODOADANARWN— O WOceOorANAMNRWN — © 


> 


00 0100 - 


USASCII 


100 0001 
100 0010 
100 0011 
100 0100 
100 0101 
100 0110 
100 O11] 
100 1000 
100 1001 


0100001 


100 1010 — 


100 1011.” 
~ 100 1100 


100 1101 - 
100 1110 
100.K11 
1010000 
101 0001 

101 0010 


101 OOtt 
101 0100 


—101 0101 


101 0110 
101 0111 
101 1000 
101 1001 
101 1010 


011 0000 


O11 0001 
051.0010. 


0110100 ~ 
0110100 — 


BCL BCL BCL 
INTERNAL EXTERNAL CARDCODE X3.4-1967 
01 0000 11 1010 12 0 
01 0001 11 0001 121 
01 0010 11 0010 122 
01 0011 11 0011 12 3 
01 0100 11.0100 12 4 
010101  —«11 0101. 12 5 
010110 110110 12> 6 
010111. 110111 12.7 
01 1000 11 1000 12 8 
01 1001 11 1001 12 9 
10.0000, 10 1010 11 0 
100001 100001 11 | 
10 0010 10 0010 11 2 
10 0011 10 0011 11 3 
100100 100100 11. 4 
100101 100101 ll 5 
10 0110 10 0110 11 6 
100111 = 100111 107 
~101000° = 10 1000 11 8 
10.1001 10 1001 11 9 
: ~ 900000 | 
110010 010010 0 2 
11 0011 010011 0 3 
110100 01 0100 0 4 
110101 01 0101 0 5 
11-0110 010110 0 6 
110111 010111 0 7 
11 1000 01 1000 0 8 
11-1001 01 1001 0 9 
000000 001010 0 
000001 000001 | 
00 0010 00 0010 22 
000011 §§000100°- 3 
00.0100: 4: 


ya 


EBCDIC BCL 


EBCDIC 


GRAPHIC GRAPHIC HEX. INTERNAL 


FS 
FO 
F7 
F8 


O ODO ~ YANN 


foe 


2. EBCDIC 1100 1111 is translated to BCL 00 0000 with an 


Fo) 


11110101 
11110110 
1111 0911 


11141 1000 


1111 1001 


DATA REPRESENTATION (Coat) | 


USASCIT 


DECIMAL EBCDIC BCL BCL BCL 
VALUE CARDCODE OCTAL INTERNAL EXTERNAL CARD CODE X3.4-1967 
245 5 05 000101 | 00 O10! 5 O11 0108 
246 6 06 00 0110 00 0110 6 OL10HIO | 
247 a 07 00 O11 00 O111 7 Oll O11F | 
248 8 10 00 1000 00 1000 8 O11 1000 
249 9 11. 00 1001 9 


. EBCDIC 0100 1110 also translates to BCL 11 1010. 


_ additional flag bit on the most-significant bit line (8th bit). This | 


function is used by the unbuffered printer to stop scanning. 


3. EBCDIC 1110 0000 is translated to BCL 00.0000 with an addi- 
tional flag bit on the next to most significant bit line (8th bit). 


_. As the print drums have 64 graphics and spaces, this signal can be | 


used to print the 64th graphic. The 64th graphic is a “CR” for — 
BCL drums and a “¢” for EBCDIC drums... 


NOTES 


4. The remaining 189 EBCDIC 


00 1001 


00 0000 (?code). 

5. The EBCDIC graphic 
| follows: 
- 

>: 

| 7 (multiply) 

| - | 

a 


EBCDIC 


(single quote) 


(not) 


(underscore) 


(or) , 


Oll 1008- 


codes are translated to BCL a 


s and BCL graphics are the same except as 


PTTC/6 CODE 


ae : 4 
|. oc 
=z i < 
qj = 
aj i 
m ud 
” Te) 


S—=| olololo|-|-|-| Ses oe 
=] efolefelolelelo\-[-]-[-[-[-]-| 
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APPENDIX C. SOURCE INPUT FORMAT AND CODING FORM 


SOURCE INPUT FORMAT 


An NDL source program is represented by aset of ordered external records. The external records could 
come from cards, tape, disk, remote device, or a combination of.these. The source information on any 
given record must be divided ‘nto two areas. Character positions | — 72 are assumed to contain clements 

of the Network Definition Language (described in sections 2 through 6 of this manual) for compilation by 
the compiler. Character positions 73 through 80 are assumed to contain information regarding the sequence 


of the input record; specifically, this area is for sequence numbers. Sequence numbers are optional. | 


There is no fixed format for source information in character positions 1 through 72. This information can 
appear in a free format form, with the following exceptions: elements contained on the card must comply . 
with any syntactical restrictions, and syntactical items cannot be continued from record to the next. For — 


~ example, the reserved word TERMINAL cannot begin on one source record and continue on the next. 
CODING FORM . | | _ 
To facilitate keypunching, as well as to provide the programmer with a suggested format to follow in 


writing his source program, printed programming forms are often used. An example of such a form appears | 
on the following page. ‘ | | | | me 


c-O 


1 


PROGRAM 1D 


5S 


SYMBOLS TO USE 


(> 


10 


| poe CENTER 


DATE 


“J 
Ww 
® 

e 


ETE 


© et | Te ee eee eee re SOURCE PROGRAM 
SOURCE PROGRAM CODE Pee yl soe on SEQUENCE NUMBERS 
(columns 1-72) ee a ee a a 7 —_ (The sequence numbers 


- _e Ces ee eee ear ae ee! Care oer ae Se in columns 73-80 cre 
a | eta. — not executed, but are re- 


| produced on the source 
ti. printout.) 


15 20 25 30. 35 402. 48 50 55 60 65 #£#+70 «=‘&P3 ve 


1 FOR DIGIT ONE, I FOR LETTER i, 0 FOR DIGIT ZERO, # FOR LETTER O, X FOR LETTER X, @ FOR MULTIPLY OPERATOR 


(C 


(C 


_ APPENDIX D, COMPILE-TIME OPTIONS. 


COMPILER CONTROL STATEMENTS 


The user is provided with the compile-time ability to sential the manner in which the compiler processes 
the source input that it accepts. The user can specify the manner in which the compiler is to receive the 
source input, the consequences of certain syntax errors, and the form of the generated compiler output. 
The compiler control statement is the medium by which these constraints are communicated to the 
compiler. Such statements are entered into the compiler by cards in the same manner as source language 
statements. Compiler control statements, entered as input to the compiler via option control cards, can 
occur at any point in the compiler input files and must contain only compiler control information. - 


An option control card is identified by the appearance of a dollar sign ($) in the first or second column of 
the card. If the $ is placed in card column 2, the option control card image is placed in the updated 
symbolic file (NEWTAPE) if such a file is generated. Compilation control information is punched in the 
succceding columns through column 72, with an eight-digit sequence number in columns 73 through 80. | 
All blanks in columns 73 through 80 represent the lowest-value sequence number. An option control card 
with no other compiler information causes the card image in the secondary input file that has the same 
sequence number to be ignored. 


The basic element of compiler control information is the compiler option, which can be invoked by the 
appearance of its name on an option control card. Two mutually exclusive states are associated with the 
majority of these options: SET and RESET; various compiler functions are dependent upon the states of 
such options. Default states are assigned to these compiler options, and the desired state of such an option 
can be specified on an option control card. Such option control cards can also contain arguments associated 
with the option. The balance of compiler options are parameter options with which no states are associated. 
The functions performed by these latter options are initiated by the appearance on an option control card 
of the appropriate epnon name and any related arguments. 


OPTION CONTROL CARDS 


Syntax 


>| |> CODE 
> DCPLIST - 
DUMP — 
> ERRLIST 
> LIMIT —_______——» (integer) 


>» LIST 


le LISTP 

o> MERGE 

» NDLMACRO 

- NEW — 

» NEWSEQERR 

» NOWARN ———————]_— 

. PAGE , , 
{> SEQ. 


> (base). +> (increment) 


SEQERR 


> SINGLE — 
- SUMMARY 


SYNTAX = 


VERSION a incremend-> . (cycle incremen t) 


+ | | =. (patch number) | 
le(rersion increment)» - -»+-» (cycle increment) -— . , 


. (patch number)- 


Semantics. 


The purpose of a compiler control statement is the assignment of a desired value or state (SET or RESET) 
to an indicated compiler option(s). Such a control statement must begin with either an explicit or an 
implicit option action. An explicit option action is defined as one of the following mnemonics: SET, 
RESET, or POP. | | 


An implicit option action is indicated when a compiler control statement contains only the names of 
options and no explicit option action. In the latter case, all options named in the compiler control state- 
ment are assigned the state SET, and all other options are assigned the state RESET. 


If a compiler control statement begins with the option action SET, the options following the option action 
are assigned the state SET; the states of all other options are unchanged. If the compiler control statement 
begins with the option action RESET, the options following the option action are assigned the state RESET; 
the states of all other options are unchanged. If the specified option action is POP, then the options have 
not been changed previously from their default states. The states of all other options are unchanged. The — 
following statements are examples of compiler control statements employine the SET, RESET, and POP 
option actions. 


$ SET LIST SINGLE 

$ RESET VOID 

$ POP NEW NEWSEQERR 
$ SET SEQ 0+100 | 


~ 


An option that has a default state of RESET is initially eine a 48-bit sack word filled with zeros; an 
option that has a default state of SET is initially assigned a 48-bit stack word with a | on top and zeros in 
the remaining positions. The top stack position denotes the state of the option at any time. Each SET 
option action causes the stacks allocated to the designated standard options to be pushed down one bit 
and a 1 to be placed at the top of each of these stacks. Each RESET causes the appropriate option stacks 
to be pushed down one bit and a 0 to be placed at the tops of these stacks. POP causes the stacks corre- 
ponding to the designated options to be POPped up one bit, causing the associated options to revert to 
their immediate previous states. Since the size of these option stacks is 48 bits, a maximum history of 48 _ 
states can be recorded. When an option control card appears that has a standard option name and an 
implicit option action, the resultant action is identical to that which would have reseulted had all 48 bits of 
each standard option stack been RESET and followed by an explicit SET performed on each indicated 
| option. F or example, after the appearance 2 an option control card containing: 


$ SINGLE 


the history stack for the SINGLE option contains a 1 in the maa stack position and all zeros in the following 
positions. The history stack for each of the other compiler options would then contain all zeros. A com- 
piler control statement that applies to compiler options begins with an explicit or implicit option action _ 
and contains a list of options to which the option action is to apply. This statement ends when the next | 
implicit option action is encountered on the compiler control card or when a percent sign is encountered 
on the compiler control card or when a percent sign is encountered or column 72 of the card is reached. 
The compiler options affected by the compiler control card retain the indicated states for all input cards - 
with sequence numbers greater than the sequence number on the compiler control card that has the 
control statement, or the physically succeeding input cards for a deck in which all sequence numbers are 
blank, until another compiler control card is encountered that alters the option states. The following 
illustration (figure D-1) is an exanpie's of a card that has pompHen control statements employing option 
actions: | | — | 


$ SET SINGLE LIST SEQ 10 +5 RESETSEQERR 00001070 
| Figure D-1. Option Control Card 
The option control card assigns the state SET to the options SINGLE, LIST, and 1 SEQ. with the sequencing 
arguments of 10 and +5. It also assigns the state RESET to the option —_ The card has the 
sequence number 00001070 in columns 73 eee 80. 
OPTIONS | 
The compiler recognizes the following identifiers as valid compiler option names: 
CODE. — -- NOWARN ee | - * = 
DCPLIST. a PAGE | | , | \wa/ 
DUMP re | | SEQ | 
~ ERRLIST ~ SEQERR 
LIMIT 7 | SINGLE _ 
LIST | | 7 | SUMMARY 
LISTP | o | _ SYNTAX 
MERGE - 4 | VERSION 
NDLMACRO | | ~ VOID. 
NEW | | YOIDT 
NEWSEQERR | | | — § 


The compiler options are Wiccan alphabetically i in the following sarieraphin The default state of each 
option is indicated in parenthcses following the option. name; the function performed by. the option is 
discusse din the paragraph accompanying the same. 


If an option control card is empty, it has no effect on other options; however, if insta is a card i image on 
the symbolic file with the same sequence number as the empty ape? control card, the i image on the 
symbolic file is deleted. | 


The compiler options are as follows: 

CODE (RESET) | 

The code option causes the printout to contain the compilergenerated object code. 
DCPLIST (RESET) 


If SET, lists code addresses of each source statement on the LINE file. (There will be two separate nets 
addresses if used for two DCPs, three for three DCPs, etc.) 


DUMP (RESET) - | | ee 


If SET, causes a “raw dump” listing of NIF on the LINE file. 
D-4. | ° | 


da 


ERRLIST (RESET) 


The ERRLIST option causes syntax error information for CANDE to be written on the ERRORFILE file. 
When a compilation error is detected in the source input, an error message is written in the ERRORFILE 
file. This option is provided primarily for use when the compiler is called from a remote terminal by the 
CANDE language, but it can be used regardless of the manner in which the compiler is called. When the 
compiler is called from CANDE, the default state of the ERRLIST option is SET and ERRORFILE is — 
automatically equated to the remote device involved. : ve a a Hh aes 


LIMIT (cannot be SET or RESET) 


The integer parameter allows the user to control compiler error terminations. The proper format for the 
LIMIT option is as follows: 7 : _ - 4 
LIMIT integer) 


Compilation is terminated if the number of errors detected by the compiler equals or exceeds the (integer) 


If no LIMIT statement appears, a default error limit of 150 is assigned unless the compilation is initiated 


through CANDE, in which case the default error is 10. 
LIST (SET; RESET for CANDE) 


The LIST option causes a printout to be generated on the compiler output LINE file. The contents of 
such printouts are specified in the preceding paragraphs describing compiler features. If the LIST option 
is RESET, only syntax error messages and compilation information are listed. we, 
LISTP (RESET) ) | | | 


When SET, the LISTP option causes patches and input records from the compiler CARD file to be — 
included on the printout while records from the compiler TAPE file are excluded. This option is effective 
only if the LIST option is RESET. If the LIST option is SET, the state of LISTP is ignored. Therefore, 
the LISTP or the LIST option causes a printout to be generated when SET. a + ee 


MERGE (RESET) 


When SET, the MERGE compiler option causes primary input, CARD file, to be merged with secondary 
input, TAPE file, to form the total input to the compiler. If matching sequence. numbers occur, the 
primary input overrides. If the MERGE option is RESET, only primary input is used and secondary input 
is totally ignored. Therefore, the total input to the compiler when the MERGE option is SET consists of 
all card images from the CARD file, and all card images from the TAPE file that do not have sequence 
numbers that can be found on cards in the CARD file. oe 7 a: | 


NDLMACRO (RESET) _ ty i eee ee | 

If SET, the NDL MACRO interface code will be printed following each statement within a( bias 
definition) or control definition) _ : gs = i | 

NEW (RESET) a. | 4 * 

When the state of the NEW option is SET, the merged input from the CARD and TAPE files is placed on 


the updated symbolic output file NEWTAPE. This file is coded.in EBCDIC and is structured in 15-word 
records and 450-word blocks. Therefore; it:can later be used as input to the compiler through the TAPE 
file. All option control cards in the merged CARD and TAPE file input are placed on the NEWTAPE file | 


when NEW is SET and only if the initial $ sign on these cards is in card column 2. 


The NEW option can be SET and RESET as necessary by option control cards appearing at any point in 
the input file. Such option control cards can also be placed on the NEWTAPE file if the $ signs on these 
cards are in column 2. | 7 | | : 


D-5 


The NEWTAPE file is created despite the occurrence of syntax errors in the source input. This file can be : 
used as a secondary input for a later compilation. | | 


The NEWTAPE file can be label-equated so that, for example, the output goes to magnetic tape. 
NEWSEQERR (RESET) | 


The NEWSEQERR option causes sequence crrors on the NEWTAPE file to be flagged. If sequence errors 
occur and the NEWSEQERR option is SET, the NEWTAPE file is not locked, and the message NEWTAPE 
NOT LOCKED {iunber of errors} NEWTAPE SEQUENCE ERRORS is printed on the printout. 
NEWTAPE, NIF, and DCPCODE files are not locked. 


NOWARN (RESET) | | 
When SET, suppresses any compiler warnings from appearing on the LINE file. 
PAGE (cannot be SET or RESET) 


The PAGE compiler option must appear on a option card without an option action ereceding it. When a 
PAGE option card appears: the printout is spaced to se top of the next page, but only? if the LIST opten 
is SET. 


SEQ (RESET) 
The proper format of the SEQ option is as follows: 
SEQ (hase) + Gincrement) 


If the SEQ option is SET, the printout and the new secondary source language file, NEWTAPE, contain 
new sequence numbers as defined by the (base) and (inc rement). If the (base) and ree are 
unspecified, a base of 0 and. increment of 10 are assumed. 


This option has effect only when the LIST and/or NEW options are also SET. The sequence numbers that 
appear on the card images in these files when the SEQ option is Se are identical to the sequence | 
numbers on the corresponding. cards in the input file. | | | | 


Example 


$ SEQ 100 + 100 


This compiler control card specifies that, when the state of the SEQ option iS SET, SeqUeNGINE begins with 
the sequence number 00000100 and proceeds in increments of 100. 


SEQERR (RESET) 


The SEQERR option causes sequence errors on the TAPE file to be aeasd’ If sequence errors occur and 
the SEQERR option is SET, DCPCODE and NIF files are not locked, and the message CODE FILE NOT 
LOCKED j number of errors} TAPE SEQUENCE ERRORS is peiatied on the printout. 


SINGLE (RESET) | 


The SINGLE option causes the printout to be single-spaced. When the SINGLE option is RESET, the 
printout is double-spaced. (Note that double-spacing is default.) 7 | 


SUMMARY (RESET) 


If SET, lists on the LINE file the memory space allocations for user translation tables and terminal. 
message space allocations for each DCP. a . 


SYNTAX (RESET) 


When SET, the source program is checked for syntax errors only. DCPCODE and NIF files are not 
generated. _ | , “ag? | , ; 


VERSION (SET, RESET, and POP are ignored by the compiler) 


The VERSION compiler option allows the user to specify an initial version number for a source program, 
to replace an existing version number, or to append an existing version number. ; 


Examples 


$ VERSION 25.010.010 
$ VERSION +01.+001.010 


When compiling with the NEW compiler option SET and a VERSION compiler card appears in the symbolic, 
and if the patch deck contains a VERSION compiler option, the new symbolic is updated to the version, 
cycle, and patch number on the last VERSION compiler card in the patch deck. The sequence number 
must be less than the one in the symbolic. — | oe . 


VOID (RESET) 


If the VOID option is SET, all input, other than $ cards, from the TAPE and the CARD files is ignored by 
the compiler until the VOID option is RESET or POPped into a RESET state. The ignored input is 
neither listed nor included in the updated symbolic file regardless of the states of the LIST and NEW 
options. The VOID option can be RESET, once it is SET, only by a option control card in the CARD file. 


VOIDT (RESET) © 


If the VOIDT option is SET, all secondary input, other than $ cards, from the TAPE file is ignored by the 
compiler until the VOIDT option is RESET or POPped into a RESET state. Therefore, while the VOIDT 
option is SET, only primary input is compiled. The ignored input is neither listed nor included in the 
updated symbolic file regardless of the states of the LIST and NEW options. The VOID option can be 
RESET, once it is SET, only by an option control card in the CARD file. , 2% = 


$ (RESET) 


When SET, the dollar sign ($) option causes the printout of all subsequent (option control card) images 
when the LIST option is SET. This option appears as $SETS or $ $. 2% | . . 4 


re 
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APPENDIX E. COMPILER SOURCE AND OBJECT FILES | 


COMPILER FILES 


Compiler communication is handled through various input and output files (figure E-1). Cards, disk, or 
magnetic tape can be specified as source language input media. Input must be in the input format defined 
in the preceding scctions. The compiler has the capability of merging, on the basis of sequence numbers, 
input from cards, tape, or disk. When inputs are being merged, indications of text insertions or replace- 
ments can be made to appear on the printout. In addition to the printout, the compiler can also generate 
updated symbolic files. These files can be created in addition to the compiler-generated output code file. 


Input Files 


The primary compiler input file is a card file with the internal name CARD; the secondary input file is a 
serial disk file with the internal name TAPE. The presence of the primary file (CARD) is required for each 
compilation; the presence of the secondary file (TAPE) is optional for each compilation. When two card 
images, one from the CARD file and the other the TAPE file have the same sequence number, the former 

is primary and is compiled, and the latter is ignored. This is the standard mode of handling source language 
input. File CARD can be either BCL-coded with 10-word records or EBCDIC-coded with 14-word records 
and can be either blocked or unblocked. File TAPE can be BCL-coded with 10-word records and 150-word 
blocks, or EBCDIC-coded with a 14- or 15-word record and 420- or 450-word blocks. Both the CARD file 
and the TAPE file can be label-equated (via the FILE system control card) to change the TITLE and 

KIND of the file. The TAPE file is used as input only when the MERGE compiler option isSET. — 


OPTIONAL UPDATED | 
>| SYMBOLIC FILE | 
(SYMBOL/SOURCENDL) 


PRIMARY 
INPUT FILE 


_|  DCPCODEFILE | 
~—H( (identifier) | DCPCODE)}| 


(NDLSOURCE) 


“NETWORK 
_ INFORMATION — 


NDL 


COMPILER 


~ OPTIONAL 


OPTIONAL LINE. 


shinai _ PRINTER LISTING 
| INPUT FILE ae (LINE) 
(SYMBOL/SOURCENDL) _ 
| | 4 _. | OPTIONAL ERROR 
_ COMPILER INPUT FILES a | a , I 
(SOURCE LANGUAGE supe Gee | MESSAGE LISTING | 
INPUT AND COMPILER - | nr | (ERRORFILE)  } 
CONTROL STATEMENTS) oe ee 
COMPILER-GENERATED 
_ OUTPUT FILES 
Figure E-1. NDL Compilation System | 
Output Files | 


Output files produced by the compiler consist of the DCP code file, the Network Information File, an 

_updated symbolic file, a line printer printout, and an error message file. The DCP code file has the internal 
name DCPCODE and is saved on disk after the compilation unless the COMPILE system control card _ 
specifies compilation for syntax only, or unless syntax errors are detected in the source language input by 
the compiler. If compilation for library is specified, then the DCPCODE and NIF files are saved on disk. 
The title of the saved DCP code file is identical to the program name (identifi wis appearing on the | 
COMPILE system control card with the suffix of /DCPCODE. 


The title of the saved Network Information File is identical to fie program name. (iden vic appearing on. 
the COMPILE system control card with the suffix of /NIF. | 


The updated symbolic file is, by default, a disk file generated only if the compiler option NEW i is SET. 
This file contains the compilation source input or a selected portion of this input as specified by the state 
of the NEW compiler option. It can be used as the TAPE file for a succeeding compilation. This output . 


file has the internal file name NEWTAPE and contains EBCDIC-coded 15-word records in 450-word 
blocks. 


The line printer printout is an optional print file that is created unless the compiler option LIST is 
RESET. (The LIST option is SET by default unless the compilation is initiated through CANDE.): The 


file has the internal name LINE, consists of 22-word EBCDIC-coded records, and contains the. following 
information: 7 | _ 2 oe eo % 


Source and compiler control statements used:as input to the compiler. 
Error messages and error count. a 3 . | 
Number of input card images scanned. 

Elapsed compilation time. | 

Processing time required for compilation. | 

Total number of words of DCP code generated. | 

Number of disk segments required for the DCP code file. 

Title of the generated code file. — 


TRmS oe sD 


Depending upon the specified setting of the LIST and CODE compiler options, the line printer printout 
can contain more (or less) information than the basic items listed above. Card images from the CARD file 
are denoted on the printout by a C aftcr the card contents. Card images from the TAPE file are denoted by 


a T in this location. A P denotes a patch of a TAPE card image. 


The output error-message file with the internal file name and assigned title of ERRORFILE is an optional 


line printer file that is created when the ERRLIST compiler option is SET. This file is normally employed 
for compilations initiated through CANDE, in which case ERRLIST is SET by default and the ERROR- 
FILE file is assigned to the remote device involved. The ERRORFILE file can also be used for compila- 
tions initiated through the card reader. This file is assigned EBCDIC-coded 12-word records that result ina _ 
line width of 72 characters, allowing the file to be used as output to a remote terminal or card punch > 
without truncation of text. When a syntax error is detected, an error message 1s written following the line 
of text. The crror message consists of an explanatory message and indicates the probable cause of the 
error. a? oe a 7 


Compiler File Table 


Table E-1, NDL Compiler Files, lists the external name of the file (i.e., the name one would label-equate to), 
the internal name of the file (i.e., the name used when the file is declared within the compiler), the 

purpose served by the file, the default KIND of the file, the code used to store file data, the default record | 
size (MAXRECSIZE) and block size (BLOCKSIZE) of the file, and a brief commentary on the specific — 

file. The attributes of any of these files can be changed by the use of FILE system control cards directed to . 


the compiler. 7 


{ SYMBOL /SOURCENDL i 


NDLSOURCE 


Input Card 
File 


SYMBOL/SOURCENDL TAPE 


| 
5 


File 


identifier) /DCPCODE. | DCPCODE | DCP Code 


NEWTAPE Updated — 

: Symbolic 

Output 
File 


INTERNAL | | RECORD BLOCK _ 
EXTERNAL NAME NAME PURPOSE KIND CODE SIZE SIZE COMMENTS 


Input Disk - 


ade E-1. NDL sis ast Files 


Blocked 
or 
Unblocked 


Required for each compilation. Primary 
compiler input file; may be label- 
equated to change file attributes. 
CANDE file is equated to this file auto- 
matically for compilations initiated 
through CANDE. Default title is 
NDLSOURCE. 

BUFFERS = 2. 

FILETYPE = 8. 


14 Words 


> 10 Words 
| 
! 
! 


420 or 450 
Words 


EBCDIC ; 140615 
| Words | 
| | 


| “109 Words 


Optional file; need not be present for | 
each compilation. Secondary compiler | 
"input file; selected as input by SETting | 
MERGE compiler option. Can be label- — | 
equated to change file attributes as | 7 


—150 Words 


desired. The default title is 
SYMBOL/SOURCENDL. 
' FILETYPE = 8. 


Generated DCP code file. Saved or dis- 
carded and assigned a title as indicated 
by compilation method. For CANDE _ 
~ compilations, the title becomes: 

OBJECT /X identifier) [DCPCODE. 


: Hexadevimal 30 Words. 420 Words 


a 
1 
a 


| Optional output file produced when 
NEW compiler option is SET. This file 
contains portions of the source input 

and is label-equatable. It is suitable for 


~ | 48 Words | 450 Words 


use as a TAPE file for a later 
- compilation. 


. . tee es ° 
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Table E-1. NDL Compiler Files (Cont) 


ae 
EXTERNAL NAME PURPOSE 


Cidentifier) /NIF Network 30 Words | 420 Words| Generated Network Information 
Information i; File (NIF). Saved or discarded and 
File assigned a title as indicated by compila- 


tion method. For CANDE compilations 
the title becomes: 
OBJECT /( identifier) /NIF. 


Optional and label-equatable file. 
| Produced when the compiler option 
_ LIST is SET. 


Optional error listing file produced 
when ERRLIST compiler is SET. _ 
Contains card images and error mes- 

sages. Automatically provided for | 
7 CANDE input. 


Item a |  -. Page 
ADAPTER... ---- essere Sana ceaeneoe Esa cor 560, 5—75, 5—136, 5—156 
ADDERR .....----e cere terete *sirileda ad Lesntgieh Gini arena ocean ae Ree Te See Ss §—32, 5-112,6-6 
ADDRESS..... Leue os sg gate aie eels aaeececk ss neers 530, 5—42, 5-62, 5—110, §—130, 5-138, 5—157 
(address size statement) occ ceccvccccn cee enceeeeees Serre er riiegutia a eeediie Sot 
De coc cakes Teena eee hones mee eres ee Se 5—40,; 5-124, 6-6 
ANSWER .......-- RR ee oe ae a ae kia O 
assignable bit variable) .....++- Kd aieniet tac atina ee ose Pee es eee 2... 5-6, 5-83, 6-3 
assignable byte variable) ss ssceodicarall Sais ia Babiana CoS re ae Oe © ee ae ane a eee acts er arse ai 56, 5-83, 6—3 
Sassignment statement) ee er ee ee A Sind dita e ete te ee ee es ‘5-6, 5-83 
AUX(LINE(BUSY)) ...------ pr re ee ee eee “gitaua we eceace ares aeeeereee 6-46 
AUX(LINE(QUEUED)) ....-----seseeercrrr ee Pe rr ee i... 6-7 
AUX(LINE(TALLY[{0 of 1}])) -e-eeeeeeeecee ec es ees esesesese nse eee 6-7 
AUX(LINE(TOG[{0 or I}])) ...-0eeeeeeeeeecnee ec eseeces cress sree 6-7 
available line adapters ......-.0eeceee cere rece c nr en emer e teers eee eee ee Satie eager 5-61 
BACKSPACE ......----: ee er ee er Te eee oe. 5-85, 5-112, 5-158 
(backspace statement) inane gills Daya. tales acne eee es sen cedemdeatante deena uae ne ane Le eS Oe 
Baudot letters and figures ..... Or rr scdputtie heise aga Waa venaca aes er 
BCC ....... sa ae dtb on tiene ae Sear ICN re eer Sas nace eer 5-30, 5—40, 543, 6—7 
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